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Overview 

Content on the Next Generation internet needs to be highly adaptive. New interfaces and devices 
are emerging, the diversity of users is increasing, machines are acting more and more on users' 
behalf, and net activities are possible for a wide range of business, leisure, education, and 

To achieve maximum flexibility and reuse, content needs to be broken down into richly tagged 
fragments that can be combined and rendered appropriately for the user, task, and context. The 
Franklin content management prototype builds on this premise. It provides an end-to-end process 
from content creation and mete-tagging to quality assurance and publishing. 

Franklin integrates several IBM technologies for its five components: content store, meta-data 
store, dispatcher, services and user interfaces. A high-level view of the components is shown in 
Figure 1 : Franklin Components. 




The content store builds upon the Daedalus (a.k.a Trigger Monitor) technology from IBM 
Watson Research. [For full specification, see 

httn://w3.watsnn.ihm.com/M:hallngr/pacers/daedalus/index,litmll Daedalus is designed to 
manage high numbers of rapidly changing content fragments. By maintaining an Object 
Dependency Graph, and by detecting changes to content, it manages pages on a web server or 
cached in a network router in a timely manner. 

The meta-data store manages tags that describe the functional and semantic role of each content 
fragment within the information collection. They may describe what the content is about, who 
the target audience is, and its relationship to a taxonomy or other fragments. The meta-data store 
also supports efficient searches. 

Networked services support the editor in content creation. They may assist the editor in meta- 
data creation, classification, summarization or translation. Instead of doing the task from 
beginning to end, the editor can accept, reject or modify the suggestions created by a service. 

The dispatcher's task is to delegate incoming requests to the content store, meta-data store and 
the services. The dispatcher presents a consistent application programming interface to the user 
interfaces. This Franklin API abides to the Web protocol for Distributed Authoring and 
Versioning (WebDAV) and to the Distributed Authoring Search Language (DASL) 
specification. 

The user interfaces communicate with the Franklin system through the API. Using the Editor UL, 
an editor can create and edit XML content fragments, upload XSL style sheets and multimedia 
objects, compose pages out of fragments, preview pages, review final published pages, and reject 
them or promote them to the final stage in the publishing flow. 

The Franklin system has also been integrated with KittyHawk, an IBM Notes based workflow 
engine. This workflow module can be turned on or off depending on the application needs. 

This document describes in detail the system requirements and setup, the architecture, 
components and features of Franklin. It covers the lessons learned, and provides a working 
example of a content collection managed with Franklin. In addition, it describes a lightweight 
version of Franklin, code-named Franklin Light, which satisfies the needs of small sites with no 
need for multiple Quality Assurance steps, or a scalable DB2 based search. 

System Setup & Configuration 

Before running an instance of Franklin to manage the content for a web site, you need to 
complete a number of installation steps. You also need to define the DTDs, the XSL style sheets, 
and the site map of the web site you intend to manage. This section outlines the required steps. 

Step 1 : Install Franklin Server 

The Franklin Server runs on an AIX or NT server and requires the following software installed 
on the same machine: 

- Apache Web Server v. 1 .3.6 or higher 

- WebSphere Application Server v.2.0 or higher 

- Java run-time environment 1.1. 8 
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The Franklin server is distributed as ajar file, i.e., Franklinjar. The distribution directory 

I contains ithe following jai files that ^teqm^byJa^toi^^j^jptOmi^^^ 

| daedalus.jar, lotusxsl.jar, xerces.jar. 

Download the Franklin Server and associated components from 

http://fraiiklin.adtech.intemetibm.com/franklirL'downIoads/index.html and place them in a 
directory accessible by the WebSphere Application Server. 

Step 2: Install DB2 for Meta-Data Store 

The DB2 database used by the Meta-data Store can run on the same machine or a different 
machine. It requires the following software: 

1) DB2 6.1 with DB2 XML Extender 7.1 

Download DB2 XML Extenders 7.1 from IBM software website at 
http://www.software.ibm.com/db2 . Currently, XML Extenders is supported on Windows 
NT, AIX and Solaris. If you decide to use the XML Extender Administration Wizard 
make sure you review the XML Extender Administration Wizard Readme file to ensure 
you have the software prerequisites, JDK 1 . 1 .x or JRE v 1 .1 .x and JFC 1 . 1 with Swing 1 , 1 

2) JDBC for DB2 JDBC 1 .20 

JDBC is included in Hie DB2 installation (db2java.zip) in the directory of sqllib/java. 

The steps to install DB2 and enable DB2 XML Extenders (which require root authority on AIX): 

1) Install a version ofTJDB higher than 5.2. We have tested DB2 XML on NT for UDB 5.2 
and 6.1, and on ADC for UDB 6.1 for DB2 XML XColumn function. 

2) Create a DB2 instance. In the included examples, we use the db2 instance name db2fmkl. 

3) Install DB2 XML Extenders 

4) Create a database in the instance. Also, create the tables and indexes based on the sample 
scripts we have provided. 

5) Enable the database with XML Extenders 

6) Start JDBC on a port. For example, "db2jstrt 4000" opens port 4000 for JDBC 
connections. 

Step 3: Customize Server Initialization Files 

B^tJranklmServletImlialization.properties |file and set the following variable to the desired 

directory in your setup: 

baseDir - base directory for all Franklin related files. 

All other variables mfranklinServletInihalization.properties are relative to baseDir and should 
not be changed: 



dldDir - directory for DTD and entity files 

xmlDir - root of the directory hierarchy for XML files 



assetsDir - directory for all directories browsable by client Ul, i.e. xslDir, publishDir, 
multimediaDir 

xslDir - directory for XSL style sheets 

publishDir - root of the directory hierarchy for HTML, HDML or DHTML flies 
multimediaDir - root of the directory hierarchy for images, graphics, video and audio 
files 

Edit metastore.ini file and set the following variables to the desired directory in your setup: 

MetaStoreServerIP - database host machine name 
MetaStoreServerPort - JDBC port number 
MetaStoreServerDBName - database name 
MetaStoreServerUserlD - database user name 
MetaStoreServerPassword - database password for the above user 
MetaStoreServerDriverClassName - database JDBC driver name 
MetaStoreServerlnitialConnection - number of initial connections to the database 
MetaStoreServerlncrement - number of additional connections to database 
MetaStoreChecklnXMLDir - temporary directory for XML files checked into meta store 
MetaStoreDADDir - directory for DAD files 

MetaStoreCacheSearchDir - directory for cached XML Search results 



Step 4: Configure WebSphere Application Server 

Start the WebSphere Administrative Console, refer to the WebSphere Quick B. 
for details 

1. In the Tasks tab of the console, select Configure a Web Application and click the start task 

a. Specify the Web Application Nan 

b. Choose the servlet engine, e.g., th 
Host, click Next 

c. Specify the Web Application Web Path, e.g., /franklinserver, click Next 

d. Specify the CLASSPATH: 

i. Add each of the jar files in the Franklin distribution to the classpath, i.e., franklin.jar, 
daedalus.jar, xml4j.jar, lotusxsl.jar, xerces.jar, patbinl32.zip 

ii. Add the db2java.zip file to the classpath, the db2java.zip file is distributed with DB2, 
it is found under the sqllib/java subdirectory of the database instance home directory 

iii. Click Finished 

2. In the same Tasks tab, select Add a Servlet and click the start task button 

a. Select Yes to "Do you want to select an existing Servlet jar file or Directory that contains 
Servlet classes" and click Next 

b. Specify the path of the directory where franklin.jar is located, click Next 

c. Select the Web Application that was created in the previous step, click Next 

d. Select the Create User-Defined Servlet option, click Next 

e. Specify the Servlet Name, e.g., dispatcher 

f. Specify the Servlet Class Name as com.ibm.adtech.franklin.server.dispatoher.Dispatcher 
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g. Specify the Servlet Web Path List, for example /franklinserver/dispatcher, this is the web 
path that should be used by the client to access the franklin server, click next 

h. Add an init parameter with Init Parm Name as baseDir and Init Parm Value equal to the 
directory where the franklin server configuration files are stored, e.g., 
/franklin/data/config 

i. Select the True option for Load at Startup; click Finished 

3. The configuration is complete you need to start the service, select the Topology tab 

a. Prior to starting the application, make sure that the database instance is running and that 
jdbc daemon is active (see previous section) 

b. Expand the topology tree and select the newly created application. The application will 
appear under the servlet engine that was selected in step l.b 

c. Right click the selection and on the popup menu select Restart Application 

4. The Franklin Server should be available at this point. In order to verify that everything is in 
order view the log files of WebSphere 

StepS: Install Franklin Client 

The Franklin Client Java Application has been tested on Windows98/20007NT. 

Download the Franklin Client Application Installer FranklinEditor.exe from 
http://frarucIin.adtech.intemetibm.(»m/franklin/downloads/index.html and run it. In addition to 
the Franklin Client, the following Java packages are required and are automatically installed by 
the Installer 

- Java 1.1.8 run-time environment with Swing JFC1. 1.1 

- XML4J package 

- WebDav package 

The Franklin Client Application Installer also creates the subdirectories required by the client 
under the chosen installation directory. You can change (hese directories as described in the next 
paragraph. 

After installation, customize the initialization file franklin.properties located in the root directory 
where you installed the Franklin Client application. You need to edit the variable browserPath to 
define the location of the web browser you wish to use to preview pages. Also, you can edit the 
variable tempDir if you wish to change the directory where temporary files are jsldredj. 

dispatcher - http://adtech ibmusl. ibm. com/frcmklinservlet/ 

initXMLFile = xml/franklinjmt.xml 

## modify browserPath to point to the web browser you wish to use for preview 

browserPath = c./Program Files/Internet Explorer/implore, exe 

## modify tempDir to point to the directory where temporary flies will be stored 

tempDir = Jtmpl 

tempMediaDir = media/ 
tempHTMLDir = html/ 
tempXSLDir = xsl/ 

standaloneP =false 
validateP = true 



Step 6: Define Document Type Definitions (DTD) 

Franklin manages two types of content objects, fragments and servables. 

A fragment is a content object that can be reused on several pages: 

- a simple fragment is a self contained XML file containing text data and metadata - for 
example, a product specification 

- a compound fragment is an XML file that contains metadata and points to an 
accompanying file such as a video or image file, an XSL style sheet, or a hand-crafted 
HTML page 

- an index fragment is an automatically updated XML file that indexes any number of 
servables - for example a panel listing the five latest press release [Future: index 
fragments not available in current implementation] 

A servable is an XML file that contains the text and meta-data for one final published page and 
imports reusable content from one or more fragments, and points to one of more style sheet 
fragments. 

Figure 2 shows a product page servable which includes content from six fragments, namely 
three text fragments, one image fragment and two style sheet fragments, and results in two final 
published pages. 

Insert Figure 2 here 

Before beginning to manage a content collection, you need to define the document type 
definitions, or DTDs, for each class of fragment and servable that will be managed by the 
application. Franklin uses the syntax of DTDs to define a document type. [See the XML 
specification at http://www.w3.org^TR/REC-xml] 

In order for Franklin to manage DTDs correctly, all DTDs must abide to the Franklin following 
specifications: 

Franklin specification of fragment and servable DTDs 

1 . The root element, to which you can give a meaningful name, must have a child node called 

LASTMODIFIEDTIME, PAGETYPE and COHTENTSIZE . Ttl9 NAME attribute of PAGETYPE must be 

set to either "fragment" or "servabt.k". 





ns editable in the Editor Ulne 



3. All elements to be indexed for search must be of type PCDATA, and must contain the 
attribute SEARCH set to YES. For example, 




Future: Need to add SEARCH attribute. The SEARCH attribute will allow Franklin to 
automatically generate the DAD mapping for the DB2 XML Extenders.. 



4. Include the external entity reference that defines the user interface widgets recognized by the 
Franklin Editor UI. Each element that needs to be editable in the Editor UI must be of type 
PCDATA and contain the DATATYPE attribute set to the appropriate UI type. 




If you wish a LONGTEXT widget to allow an editor to enter a limited set of HTML tags, add the 
PARSE attribute and set it to true. The supported HTML are: 



The file uitypes.txt is fixed and provided in the Franklin install in the dtdDir in the 
franklittproperties file. It contains the list of all UI widgets known to Ihe Editor UI. (See section 
Editor UI Widgets for a detailed description of UITYPES) 

BROWSELOCAL ] ASSOCLIST 



10 



5. An element can appear as a drop-down menu in the Editor UI and restrict the editor to choose 
the value from a predefined set To accomplish this, set the DATATYPE attribute to the 
UITYPE "CHOICE" and the CHOICES attribute to a default value from a list of options. The 
options can be defined as an external entity for reuse across many DTDs. 




For example, the options for category could be defined as the types of NetEnity servers: 
NONE I Netfinity_8500R I Netf inity_7000_MlO I Netf inity_5500_M10 I 



The Editor UI assumes that if the first word in the set of CHOICES is the string NONE, and the 
editor selects it, the element will not appear in the XML document. 

6. A fragment can include other fragments as subfragments. If so, the entity reference that 
defines all subfragment types must be included in the DTD. The declaration of a subfragment 
must contain the subfragmenttype attribute set to the appropriate type. 




Future: the subfragment syntax will be replaced by the XLink syntax once it becomes a W3 
recommendation and XML4J and LotusXSL support the syntax. Until then, we will use 
subfragment elements as way to include content from another fragment. 



An example of a fragment DTD, listfragmentdtd: 
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Franklin specification of compound fragment DTDs 

A compound fragment contains a pointer to an accompanying file, such as a multimedia file, an 
XSL style sheet or a hand-crafted HTML file (i.e. ones that are not generated from XML by 
Franklin) The accompanying file is encoded as a binary object into the fragment for the duration 
of the communication between Editor UI and Franklin Server. Before check-in to the server, the 
Editor IH encodes the file as a binary object into the XML fragment. At the receiving end, the 
dispatcher extracts it and decodes into the original format. The reverse happens at check-out. 
This allows a single communication between the client and server when exchanging this type of 



se the following syntax to declare the inclusion of an 



Franklin specification of group Index fragment DTDs 

Future: To be filled in 

Franklin specification of servable DTDs 

In the Franklin system, servables always result in one of more final published pages. The DTD 
must indicate the names of the XSL style sheets it can use for layout and where to publish the 
resulting pages. 



1. A servable DTD must contain the following declarations: 




2. A servable can include one or more subfragments. Each subfragment serves a specific role 
within the servable and can be named in a meaningful way, for example MAEMPHOTO, 
HIGHLIGHTS etc. Each subfragment must have an attribute that indicates the type of 
subfragment to include. The syntax to include a subfragment in a servable follows: 
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■tfig. xml</HIGHLIGHTS> 

in the directory defined by the 

After updating, adding or deleting any DTDs, update the files configDir/dtds.xml and 
dtdDir/subfiagmenttypes. txt to reflect the current DTDs. Also remember to define a DAD file to 
for each DTD. (Future: DAD explanation should be expanded) 



Step 7: Define Style Sheets 

For each servable DTD, you need to define one or more XSL style sheets that will be assembled 
with the servable XML and the XML of any subfragments into the final published pages. A style 
sheet is written using the XSL syntax to produce HTML, DHTML, HDML or other desired 
output. [See the XSL Transformations syntax at http:/Avww. w3.org/TR/tpliJ 

Franklin specification of XSL style sheets 

Because the servable includes content from subfragments, the style sheet must be written to work 
on the so-called expanded servable. Before page assembly, a servable is temporarily rewritten to 
include the content of all its subfragments. Because the XLink standard has not been finalized, 



IS 



[Add here, the definition of a debug style sheet, what is should do, and where it should be saved 
on the server] 



Step 8: Create Directory Structure 

Create the directory structure that corresponds to the site map of your application. Under 
publishDir create the HTML directories, and under multimediaDir the multimedia directories. 

If your site is published to more than one audience segment or device, define several sibling 
directory structures under publishDir. For example, a site published for two devices, one for 
browsing all content using a web browser, and another for browsing only the news section using 
a pda browser, could have the following directory structure: 

publishDirAveb/ 

publishDir/web/news/ 

publishDir/web/products/ 

publishDir/pda/ 

publishDir/pda/news/ 

multimediaDir/images/ 

multimediaDir/audio/ 

When an editor authors a servable, the PUBLISHDIR element of the servable will be presented 
in the UI with the BROWSESERVER widget. This widget allows the editor to browse the 
directory structure under assetsDir and select where to save the resulting file. Similarly, when 
editing a multimedia object, the widget allows the editor to browse the directory structure to 
select where to save the binary file. 

Step 9: Configure Web Server 

To browse the published sites, set up a web server for each sibling site. Configure the Document 
Root variable to point to the top of the directory hierarchy of a sibling site. The example below 
assumes that the boseDir in franklinServletInitialization.properties is set to "/franklin/data/": 

For the example in the previous section, you would set up two web servers: 
Web Server 1: DocumentRoot 'Vf ranklin/data/publish/web/" 

Also, add the aliases below to the configuration file of Web Server 1 and 1. 




Set directory browsing "on" so that you can easily browse the DTDs and verify the uploaded 
XML files, XSL style sheets, and multimedia files. 
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Step 10: Define Roles & Users 

Before running the Editor UI, you need to define the allowed roles and users of the Franklin 
system. A role is defined by the list of DTDs the role is allowed to edit. A user is defined by one 

To define new roles, edit the file corfigDir/roles.xml by importing the DTD conflgDir/roles.dtd 
to an XML editor such as Xeena from IBM alphaworks. (Future: use the Editor UI to edit the 
file) 

The DTD roles, did: 




An example roles.xml defines two roles, FragmentEditor and Editor and associates the allowed 




To define new users, edit the file configDir/users.xml by importing the DTD configDir/users.dtd 
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When the Franklin server is initialized, the Dispatcher module runs Globak.loadinfoQ. This 
method merges users.xml, rolesxml and dtds.xml into one DOM in memory for fast access. The 
method verifies that all roles named in users.xml have a definition in roles.xml. It also verifies 
that all DTDs named in roles. xml are defined in dtds.xml and exist in the named directory. If any 
discrepancies are detected, the server prints out a warning message. (Future: the verification still 
needs to be implemented.) 

(Future: if any of the configuration files have changed after the server was last initialized, the 
files will get reloaded and the DOM will get refreshed. This will not have an effect on any users 
currently logged on.) 

Editor Interface & Dispatcher Communication 

After installing the Editor User Interface application and completing the customization described 
in Section Install Franklin Client, launch the application from the Franklin Editor icon on the 

All communications between the Editor UI and the Franklin Dispatcher follow the WebDAV 
protocol. [See the full specification at http://www.webdav.org/specs/] 

The HTTP header of a Client request always contains the following attributes with ACTION 
replaced by PUT, GET, LOCK or WLOCK,fi-anklinservemame replaced by the name of the 
Franklin server the client is communicating with, and length replaced by the length in bytes of 
the body section. 




The body of the Client request contains the XML document to be checked into the server or a 
DASL search query. 

The HTTP header of the Dispatcher response always contains the following attributes with 
errorcode and message replaced by the standard codes listed in Appendix 1 . 
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Hie format of the body of the Dispatcher response depends on the request and whether the 
| request was successfully completed or not. 



A special format used for the response follows the DTD below. In the further examples, the use 
of the elements will become obvious. 




The editor logs in using the user name and password defined by the Franklin administrator, as 
defined in Section Define Roles & Users. 
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From this franklin initxml document, the Editor UI builds the File > New Fragment and File 
>New Page menus. It also maintains the mappings between display names and DTD URLs in a 
hash table. 

The Editor UI can be set to load all DTDs at this point, if it is important to enable off-line 
editing. We have chosen to load a DTD from the server upon demand for a faster startup process. 
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At this point, the editor is able to either create new content or search for existing content in the 
Create new content 

The File > New Fragment menu lists all fragments and the File > New Page menu lists all 
servable pages the editor is allowed to create or edit. If the editor selects to create a new 
fragment, e.g. a TEXTFRAGMENT, the Editor UI gets the DTD from the appropriate URL and 
automatically generates a template from the DTD, as shown below: 

[Include screenshot here] 

In parallel, the Editor UI maintains in memory a DOM corresponding to the DTD. 



Editor UI Widgets 

The Editor UI uses the DATATYPE attributes in the DTD to generate the appropriate Java 
widget in the user interface. If an element does not contain a DATATYPE attribute no input is 
allowed for that element. Children elements may still contain DATATYPE attributes to specify 
their user interface. The mapping between Franklin UITYPEs and Java widgets are given below: 




Each Java widget is encapsulated in a set of classes diat include additional functionality. For 
example, if an element in the DTD is required, e.g. TITLE, the widget will be highlighted (e.g. 
colored brightly) to help the editor distinguish which fields must be filled in. If an element can 
appear more than once, e.g. KEYWORD, +/- buttons appear next to the widget that allow 
duplicating the widget or group of widgets. 



BODY tags are handled specially within the system. The system assumes that BODY tags are 
composed of 1 or more PARAGRAPH tags. Typically, this is represented by a longtext widget in 
the user interface. Blank lines in the input are interpreted as paragraph separators. When 
constructing the DOM object, these paragraphs are composed within the outer BODY tag. 

Check-in of New Fragment 

When the editor has filled in the template in the UI, clicking on the check-in icon verifies that all 
required elements are filled in. If so, the DOM in memory is populated with the data in the UI 
widgets. New nodes are added if new instances of an element have been created using the +/- 
buttons. Nodes are removed from the DOM if optional fields have not been filled in. Once the 
DOM mirrors exactly the UI, the document is transformed to an XML string and a request is sent 
to the Dispatcher with the XML as the body. 
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Note that the only time a check-in request to the Franklin Dispatcher does not include the file 
name containing jragmentid is when uploading a new fragment. The absence of a fragmerttid 
indicates to the server that a new, unnamed fragment is being checked-in. The Dispatcher assigns 
| ^nigue ids to all fragments. 



Client request: 




If check-in is successful the Dispatcher returns the SYSTEM data of the XML document filled in 
with the newly created unique fragmenlld, and the authoring information, as described in Section 
XXX. The client merges the SYSTEM tag into the existing XML document. The Editor UI now 
has the complete XML. 



Dispatcher response: 
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If the fragment about to be checked in has an accompanying content file, i.e. a multimedia asset 
or an XSL style sheet, the Editor UI encodes the contents using Base64encoding into the 
CONTENT element in the XML. On the server side, the Dispatcher un-encodes it and writes the 
file to the file system, as described in Section XXX. This method avoids sending multiple 
requests to the Dispatcher and having to maintain state between two requests. 



Check-In of Modified Fragment 

If the Editor UI checks in a modified fragment or page, it will have received a locktoken from 
the Dispatcher before checking it out. The check-in request in this case must include the 
| LockTocken header field, _.- \ Deleted: ) 

Client Request 



The dispatcher verifies that the correct lock token is supplied with the PUT request before it 
processes the request. The dispatcher changes the MODIFIER and the LASTMODIFIEDTIME 
fields in the SYSTEM element 

After the check-in command, the Editor UI issues an unlock command using the appropriate 



The Dispatcher verifies the locktoken as described in Section XXX, and returns an OK if the 
token is correct, otherwise it sends one of the two Franklin lock errors: 

# L101 = Lock tokens do not match 

# L102 = Missing lock token 
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Check-out 




ted fragment, the dis 



Now the Editor UI can request the fragment for editing using the lock re 



Dispatcher response: 



Length: length 



The Editor UI retrieves the DTD of the checked-out fragment from the server if it has not yet 
loaded it Using the DTD it auto-generates the UI widgets and then fills in the existing values 
from the checked-out fragment, adding new instances of elements using the +/- mechanism when 
necessary. 

The editor can modify the fields in the same way as when creating new content. Upon check-in 
the Dispatcher updates the lastmodifedtime and modifier fields in the system data of the 
checked-in XML document 

Search 

Clicking on the Search icon in the Editor UI brings up the Search dialogue shown below: 
[insert Search screen shot here] 

When launched, the Search dialogue parses frankltn_init.xml and stores attributes, operators and 
allowed values into hash tables. It dynamically generates the widgets for the query composition. 
When new attributes or values are added to franklin miuxml. the Search code does not need to 
be updated. 

The Search UI communicates with the Dispatcher using the Distributed Authoring Search 
Language (DASL) [add ref], an extension to the WebDAV protocol. Franklin Server defines the 
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Hie Dispatcher passes the query to the Meta Data Store where the query is converted to SQL and 
executed against DB2. The results are converted back to the DASL format. 
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The Search UI parses the results and displays them in the results table. From the table, the editor 
can select items and merge them into the Active List in the Editor UI. 

Future: If more than the requested number of hits exist in the database, the Search UI uses the 
responsesummary element in the result list to determine how to manage the "Next" and 
"Previous" buttons that allow further results or to go back to a previous set of results. 

Preview 

Before checking in a servable, the editor can preview the final page to be published. The preview 
icon in the Editor UI is active only when editing a servable. Requesting a preview sends a 
request to the Preview Manager servlet with the temporary contents of the servable XML. The 
Preview Manager expands the servable with contents of any subfragments, assembles the page 
with all included style sheets using LotusXSL, and returns the resulting HTML output to the 

The Editor UI launches the web browser specified in the franklin.properties file and displays the 
temporary output. Once satisfied, the editor can check in the servable. Servables previously 
checked in (e.g., servables returned as search results) can also be previewed. 

(Future: preview of an HTML page does not indicate to the editor which fragment produced any 
given area of the page. Need to devise a way to display the source element.) 

Dispatcher 

Session Management 

When a user logs on using the Editor UI, as described in the Section Editor Interface & 
Dispatcher Communication: Login, the dispatcher checks for a valid user and password by 
consulting the DOM, generated at startup, which contains all user information. If they are valid, 
the dispatcher adds the user to the currentusers hash table and generates a unique session 
identifier, sessionld. Sessionld is created using the java UIDQ call that guarantees to return a 
unique identifier for the machine the process is running on. 

If the same user logs on a second time from another terminal without terminating the earlier 
session, the earlier sessionld in overwritten by a new one, and the old session becomes invalid. 

At logout, the users entry is removed from the currentusers hash table. 

Future: the class that manages the user sessions must be serializable, so that its state can be 
saved and reloaded if the Franklin Server servlet needs to be restarted. 

System Data Creation 

When a dispatcher receives the check in request from the Editor UI, it handles new and modified 
fragments differently. 
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For a new fragment, the Dispatcher fills in the following so-called system elements in the DOM 
built from the incoming fragment: 




fragmentid is the unique identifier for the fragment. This identifier is created using the java 
UID() call which returns a guaranteed unique identifier for the machine where the process is 
running. To the UID, the dispatcher appends the suffix -tfrg.xml for simple fragments, -bfrg.xml 
for compound fragments, or -tsrv.xml for servables. To know which suffix to append, the 
dispatcher consults the dtdToType hash table, built at startup to cache the mapping between 
DTDs and their types. 

creator is the name of the user who originally checked in the new fragment. The dispatcher gets 
this name by calling the sessionidToUser method, which retrieves the user name from the 
currentusers hash table based on the sessionld. 

modifier is the name of the user who is currently checking in the fragment, modifier and 
creator are the same when creating the system data for a new fragment. 

creatioktime is the Java generated time stamp of the system data creation time at original 
check-in. 

lastmodifiedtime is the Java generated time stamp of the system data update time at 
subsequent check-ins. creationtime and lastmodifiedtime are the same for a new 
fragment. 

pagetype is set to either "fragment" or "servable". The dispatcher sets fagetype by 
consulting the dtdToType hash table, built at startup to cache the mapping between DTDs and 
their types. This field is important because processing of fragments and servables is different in 
the Editor UI as well as in the content store module. 

cohtehtsize is the size in bytes of the checked-in fragment including any included binary data. 
The dispatcher calculates this after filling in the system data but before extracting any binary 
data. Thus, this is the size of the string being sent over the network between Editor UI and the 
dispatcher. 

Name Space Management 

The name space manager module of the dispatcher manages all reading and writing of files. It 
abstracts away the actual file system from all other modules, so that they do not have to keep 
track of specialized directories. 
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The name space manager provides the functionality to read and write into the file system DOMs, 
corresponding XML strings that represent fragments or servables. At dispatcher startup, the 
initialization file is read in, and the variables defining the directories become available to the 

When writing a compound fragment, the name space manager also extracts any encoded 
multimedia files and style sheets and writes them into the appropriate directories. On the other 
hand, when reading a compound fragment, it encodes any external files into the XML and 
returns the DOM to the module requesting it. 

In addition to the dispatcher, the content store uses the name space manager as well. The content 
store uses it to read fragments from the file system and to write HTML/HDML/DHTML output 
files from page assembly into the file system. 

The advantage of separating the name space manager from the rest of the Franklin server is to 
isolate the knowledge about dedicated file system directories to one module. For example, if 
xmlDir needed to be split up into a series of second-level directories to limit the size of any one 
directory, only the name space manager would need to know about the change. Under xmlDir 
could reside 10 child directories 0/, 1/, ...9/ and a fragment would be stored in one of them based 
on a load-balancing algorithm handled by the name space manager. 

Coordination Between Modules at Check-in 

[describe the 3 phase save to file system, meta store and tm, with the fact that tm is 
asynchronous. Maintenance of pending jobs table by dispatcher, and roll-back] 

Lock Management 

As described in the sections Editor Interface & Dispatcher Communication: Check-in and 
Check-out, the Editor UI and dispatcher exchange lock tokens during the LOCK and UNLOCK 
requests from the Editor UI. 

When the dispatcher issues a lock token, it uses the Java UIDQ call to create a unique identifier. 
It sends the token along with the user name and the lock time to the Editor UI in the body of the 
response and stores another copy of this information in the meta-data store as described in the 
section Meta Data Store: Lock Management 

When the dispatcher receives an UNLOCK request with a lock token from the Editor UI, it needs 
to verify that the token matches the one stored in the meta-data store. If they match, the 
dispatcher issues a call to delete the lock in the meta-data store. 

The dispatcher has two other ways to manage locks if problems occur. If the Editor UI requests 
that all locks held by the current user be released, the dispatcher issues the call 
releaseLockByUser to the meta-data store. When the dispatcher is restarted due to a system 
crash, all pending locks in the meta-data store can be released at startup with the call 
releaseLockAll. 
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Error Handling 

All Franklin server side components abide to the same Franklin error handling scheme. When 
any of the components called by dispatcher, namely meta-data store, name space manager, user 
manager, or content manager, catch or throw a Java exception, they convert it to a Franklin 
exception and fill in all details about the context and the conditions where the error occurred. 

A Franklin exception contains the following attributes: 

myError - the Franklin error code 

myHttpError - the HTTP error code corresponding to the Franklin error code 
myMessage - explanation of error, presented to user of the Client application 
myDestination - one of ERRORUSER, ERRORLOG, ERROR_ ADMIN to indicate 
where the error should be directed 

myException - the originally caught exception, if there is one 

The dispatcher module routes the exception based on the attributes. If myDestination is set to 
ERROR USER, the dispatcher returns the exception to the Editor UI which displays the error to 
the user. If it is set to ERROR LOG, the error is written to the error log file, and for 
ERRORADMIN, the process notifies the system administrator. 

Meta Data Store 

The meta-data store allows the indexing and searching of fragments and servables. All or a 
subset of the XML elements can be set to be indexed. For a large content site this allows users to 
quickly locate content objects of interest. The meta-data store also manages the lock information 
of content objects. 

DB2 XML Extenders 

Franklin uses XML Extenders for DB2 to index a subset of the XML elements of fragments and 
servables. To accomplish indexing, XML Extenders uses a Document Access Definition (DAD) 
that maps an XML element to a column in a DB2 table. 

DB2 XML Extenders provides two different methods, namely XColumn and XCollection. We 
have implemented both methods in Franklin and decribe both in this document. We recommend 
using the XCollection as it is more flexible. 

XColumn 

The current XColumn implementation of XML Extenders can only map one DTD to one or more 
DB2 tables. In order to map all Franklin DTDs to one or more common tables, the dispatcher 
converts all DTDs to a so-called universal DTD, which contains all elements to be indexed in the 
set of DTDs. For this universal DTD, two DADs are created based on the XML Extenders 

Two DADs are needed, because the current XColumn implementation does not support inserting 
elements that occur only once in the XML and those that occur more than once using a single 
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DAD. Thus, the examples in this section show two DADs that map values from the universal 
DTD. 

When designing the DADs, all elements that appear only once, or single-occurrence elements, 

elements, need to be mapped each into separate dedicated tables. The administrator creates a 
view between the single-occurrence table and the multi-occurrence tables to perform searches 
across all tables with one command. 

A DAD specifies the following items: 
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Example of a DAD mapping multi-occurrence elements: 




The tables created by these DADs are shown in the Section Table Design. 
XCollection 

The XCollection implementation of XML Extenders requires one DAD for each DTD to be 
mapped into DB2. Unlike XColumn, different DTDs can be mapped to the same DB2 tables. 
Thus, the XCollection implementation does not required documents to be converted to abide to 
one universal DTD. 

[However, the current XCollection also has a few problem. We have implemented a temporary 
fix into the meta data store until the problems are addressed] 

The DAD corresponding to textfragmentdtd is shown below: 
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[add DAD here] 



Table Design 

When a DAD is loaded into DB2, the tables and columns specified in it are automatically 
created. After the tables are created, the administrator needs to add the following items to the 
database: 

- a column named ISCOMMIT in the table storing the single-occurrence elements. Th: 
column indicates if the fragment has successfully been committed to the content ston 
and file system 

- indexing on any columns that will be searched 

- a view which combines data from all tables for searching 



vMCBAR(64> 




When a fragment or servable is checked in, the dispatcher converts the XML file to abide to the 
universal DTD for indexing in the XColumn implementation. After the conversion, it sends the 
universal XML to the meta-data store. In the XCollection implementation, the fragment or 
servable is sent as is to the meta-data store. 

For XCollection, the meta-data store enters a pointer to the file into the two tables named 
UNITFRAG1 and unifrag2 in the previous example. When the record is entered, a trigger copies 
the elements specified in the DAD to the appropriate tables. The elements are now ready for 
searching. 

For XColumn... 
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An example DASL output to above query: 




If the number of results is larger than the result set requested by the Search UI, the meta-data 
store writes the full results into a cache file and only encodes the requested number into the 
DASL output. The cache file is named using an expression that encodes the query and the 
sessionld of the user. When the Search Ul requests the "Next" set of results for the same query, 
the meta-data store does not re-execute the query. Instead it consults the cache file and extracts 
the appropriate next set of results. This caching scheme saves the meta-data store from executing 
the same query several times if the user if simply navigating within the same result set. 

Note that if the contents where to change in DB2, the user does not see the updated results until 
he re-executes the original query without the "Next" or "Previous" flags. 

Lock Management 

When the dispatcher receives a lock command from the Editor UI, it creates a lock for a 
fragment or servable and sends the lock to the meta-data store to save in DB2. The lock 
information, namely locktokek, lockedowuer, and locktime, is stored in the meta. lock 
table of the following format: 



FRAMENTID CHAR(56) 




When the dispatcher receives 
command to the meta-data st< 
table. 

The Content Store - Daedalus (a.k.a Trigger Monitor) 

This section describes how the Franklin project has extended three of the Daedalus handlers to 
enable the system to manage XML fragments and XSL style sheets. For the full Daedalus API 
documentation, read http://w3.watson.ibm.com/~challngr/papers/daedalus/index.html. 
Daedalus is written in pure Java and implements handlers as pre-defined actions performed on 
the various configurable resources. Flexibility is achieved via Java's dynamic loading abilities, 
by more sophisticated configuration of the resources used by Daedalus, and through the use of 
handler preprocessing of input data. Most entities defined in a configuration file implement a 
public Java interface. Users may create their own classes to accomplish localized goals, and 
specify those classes in the configuration file. This permits run-time flexibility without requiring 
sophisticated efforts on the part of most users, since default classes are supplied to handle the 

ee handlers: the Extension Parser, 



Extension Parser 

Within Franklin, Daedalus manages different types of files differently bs 
Servables, simple, compound, and index fragments, style sheets and mul 
treated slightly differently in the publishing flow. 



Dependency Parser 

The Franklin Dependency Parser reads through an XML objects that has been checked in and 
detects two types of dependencies: 

1. Servables and fragments can include subfragments, these get stored as an edge of type 
"composition" in the Daedalus Object Dependency Graph (ODG). 

2. Compound fragments include an associated content file, this dependency gets stored as 
an edge type "composition" in the ODG. 

3. Servables can include style sheets, these get stored as an edge type "stylesheet" in the 
ODG. 
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Dependencies are considered to point from the subfragments to the fragments that include them. 
For binary wrappers, one composition dependency points from the wrapper to the fragment that 
includes it, and another points from the wrapper to the binary data file that it wraps. For 
stylesheets, a composition dependency points from the wrapper to the stylesheet, and a stylesheet 
dependency points from the stylesheet to the servable that uses it. 

Page Assembler 

The Franklin Page Assembler expands a servable by including the contents of all included 
subfragments, and combines the resulting XML with the one or more style sheets using 
LotusXSL to produce HTML output files. The extension of each of the resulting files is 
determined from the stylesheet names (e.g. web_xxx_htmlxsl). The assembled XML and all the 
resulting HTML files are written to one file, which is later split up in the Dispatcher, and the 
HTML files are written to the appropriate directories in the sink or server. 



Chaining of Trigger Monitors 

Currently, two Trigger Monitors are used in the publish process. They share an ODG, and the 
sink of the first one is the source of the second, creating a publishing chain. The following 
diagram shows the set-up of the Content store in its entirety: 




When a fragment is checked in to the Content store, it is added to the shared ODG, and a publish 
command is issued to the first TM. The TM reads the fragment XML from the source servlet, 
uses the extension parser to find its extension, and then uses the dependency parser to find 
dependencies to add to the ODG. The page assembler then pulls in the contents of the 
fragment's subfragments, and if the fragment is a servable, combines it with its stylesheets to 
produce the output HTMLs. The servable XMLs, output HTMLs, binary files, and stylesheets 
are sent to the servlet specified as the sink of the first TM. 

When a servable has been approved, a publish command on the servable fragment is issued to 
the second TM. It is reassembled and recombined with its XSLs, and the resulting XML and 
HTMLs are published to the second sink servlet. Binary files (such as images) are also 
published to the second sink. This is where the web server pulls the final HTML and image files 

Example application 

- managing Natfinity pages at ibm.com 

Summary 



Appendix 1: Error Codes 

# Status code (101) indicating the server is switching protocols 

# according to Upgrade header. (SC_SWITCHING_PROTOCOLS) 

XI = 101 

# Status code (200) indicating the request succeeded normally. (SC_OK) 

G200 = 200 
P200 = 200 
OK = 200 

# Status code (201) indicating the request succeeded and created 

# a new resource on the server. (SCCREATED) 

X3 = 201 

# Status code (202) indicating that a request was accepted for 

# processing, but was not completed. (SC_ACCEPTED) 

X4 = 202 

# Status code (203) indicating that the meta information presented 



# by the client did not originate from the server. 
(SC_NON AUTHORITATIVE INFORMATION) 



X5 = 203 

# Status code (204) indicating that the request succeeded but that 

# there was no new information to return. (SC_NO_CONTENT) 

X6 = 204 

# Status code (205) indicating that the agent <em>SHOULD</era> reset 

# the document view which caused the request to be sent. (SCRESETCONTENT) 

X7 = 205 

# Status code (206) indicating that the server has fulfilled 

# the partial GET request for the resource. (SCJPARTIAL CONTENT) 

X8 = 206 

# Status code (300) indicating that the requested resource 

# corresponds to any one of a set of representations, each with 

# its own specific location. (SC_MULTIPLE_CHOICES) 

X9 = 300 

# Status code (301) indicating that the resource has permanently 

# moved to a new location, and that future references should use a 

# new URI with their requests. (SC_MOVED_PERMANENTLY) 

X10 = 301 

# Status code (302) indicating that the resource has temporarily 

# moved to another location, but that future references should 

# still use the original URI to access the resource. (SC MOVED TEMPORARILY) 

XI 1 =302 

# Status code (303) indicating that the response to the request 

# can be found under a different URI. (SC_SEE_OTHER) 

X12 = 303 

# Status code (304) indicating that a conditional GET operation 

# found that the resource was available and not modified. (SC_NOT_MODMED) 
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X13=304 



# Status code (305) indicating that the requested resource 

# <em>MUST</em> be accessed through the proxy given by the 

# <code><em>Location</em><ycode> field. (SC USE PROXY) 



# THIS IS THE GENERAL (DEFAULT) ERROR RETURNED WHEN ANYTHING BREAKS 



C103 = 400 
C123 = 400 
C124 = 400 
D104 = 400 
DUO = 400 
P101 = 400 
V101=400 
F100 = 400 
FI01 = 400 
F102 = 400 
F103 = 400 
F104 = 400 
F105 = 400 
R101 = 400 
R112 = 400 
R102 = 400 
R103 = 400 
R105 = 400 
D101 =400 
D1 1 1 = 400 



G101 =401 
U101 = 401 
U102 = 401 



L101 =401 
L102M01 
G104 = 401 

# Status code (402) reserved for future use. (SC_PAYMENT_REQUIRED) 
X17 = 402 

# Status code (403) indicating the server understood the request 

# but refused to fulfill it. (SCFORBIDDEN) 

G102 = 403 
D123 = 403 

# Status code (404) indicating that the requested resource is not 

# available. (SC_NOT_FOUND) 

X19 = 404 

# Status code (405) indicating that the method specified in the 

# <code><em>Request-Line</em></code> is not allowed for the resource 

# identified by the <codeXem>Request-URI</era></code>. 
(SC_METHOD_NOT_ALLOWED) 

X20 - 405 

# Status code (406) indicating that the resource identified by the 

# request is only capable of generating response entities which have 

# content characteristics not acceptable according to the accept 

# headerssent in the request (SC_NOT_ACCEPTABLE) 

F108 = 406 

# Status code (407) indicating that the client <em>MUST</em> first 

# authenticate itself with the proxy. (SC_PROXY_AUTHENTICATION_REQUIRED) 

X22 = 407 

# Status code (408) indicating that the client did not produce a 

# requestwithin the time that the server was prepared to wait. (SC_REQUEST_TIMEOUT) 
X23 = 408 

# Status code (409) indicating that the request could not be 

# completed due to a conflict with the current state of the 

# resource. (SC_CONFLICT) 

X24 - 409 
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# Status code (410) indicating that the resource is no longer 

# available at the server and no forwarding address is known. 

# This condition <em>SHOULD</em> be considered permanent. (SC_GONE) 

X25 = 410 

# Status code (41 1) indicating that the request cannot be handled 

# without a defined <code><em>Content-Length</em></code>. (SCJLENGTH_REQUIRED) 
X26 = 411 

# Status code (412) indicating that the precondition given in one 

# or more of the request-header fields evaluated to false when it 

# was tested on the server. (SC_PRECONDITION_F AILED) 

X27 = 412 

# Status code (413) indicating that the server is refusing to process 

# the request because the request entity is larger than the server is 

# willing or able to process. (SC_REQUEST_ENTITY_TOO_LARGE) 

X28-413 

# Status code (414) indicating that the server is refusing to service 

# the request because the <code><em>Request-URl</em></code> is longer 

# than the server is willing to interpret. (SC_REQUEST_URI_TOO_LONG) 



# Status code (415) indicating that the server is refusing to service 

# the request because the entity of the request is in a format not 

# supported by the requested resource for the requested method. 
(SC_UNSUPPORTED_MEDIA_TYPE) 

X30 = 415 

# Status code (500) indicating an error inside the HTTP server 

# which prevented it from fulfilling the request (SCJNTERNAL_SERVERJERROR) 

X31=500 

# Status code (501) indicating the HTTP server does not support 

# the functionality needed to fulfill the request. (SCJNOT IMPLEMENTED) 



X32 = 501 



# Status code (502) indicating that the HTTP server received an 

# invalid response from a server it consulted when acting as a 

# proxy or gateway. (SC_BAD_GATEWAY) 

X33 = 502 

# Status code (503) indicating that the HTTP server is 

# temporarily overloaded, and unable to handle the request. (SC_SERVICEJJNAVAILABLE) 
X34 = 503 

# Status code (504) indicating that the server did not receive 

# a timely response from the upstream server while acting as 

# a gateway or proxy. (SC_GATEWAY_TIMEOUT) 

X35 = 504 

# Status code (505) indicating that the server does not support 

# or refuses to support the HTTP protocol version that was used 

# in the request message. (SC_HTTP_VERSION_NOT_SUPPORTED) 

X36 - 505 

# Error code in server.dispatcher.Dispatcher 

# D104 = Error in Dispatcher.doPostO 

# DUO = Fragment Type not Specified or incorrect 

# P101 = Error in Dispatcher .putParseRequestO 

# V101 = Error validating user 

# Error codes in serverFragment 

# F100 = Error in Fragment.fragment2XML() 

# F101 = Error opening Fragment.XML2fragmentO 

# F102 = Error parsing XML file in Fragment.XML2fragment() 

# F103 = Error calling readNode("+element+") 

# F104 = Error calling getElementValue 

# Fl 05 = Error calling getElementType 

# F120 = Cannot close StringWriter 

# Error codes in server.TextUtils 

# R101 - Error in TextFile.read("+filename+") 

# Rl 12 = Error in TextFile.readTextFileWOException("+filename+") 

# R102 = Error in TextUtils.createDOMfromFile("+xmlfile+") 



# R103 = TextUtils.createDomFromFile SAX exception 

# R105 = TextUtils.createDomFromFile IO exception 

# Rll 2 = Error in TextFile.readTextFileWOException("+filename+") 



# Error codes in server.dispatcher.DomUtils 

# D101 = DomUtils.documentToTuniverse TXDOM Exception 

# Dl 1 1 = Error in DomUtiIs.documentToUniversal 

# D123 = Missing or invalid sessionID on checkin 

# Error codes in server.dispatcher.Users 

# these have destination ERRORUSER 

#U101 = User + username + not defined 

# U102 = Wrong password for user + username 

# U103 = User with sessionid + sessionld + not defined 

# this has destination ERROR_LOG 

# Ul 1 0 = Users.methodname IO exception 

# Error codes in server.dispatcher.checkln 

# C103 = Error in document2String 

# C102 = Checkin Error 

# CI 01 = Users.checkProvledge error 

# DEI 11 = Delete Error 

# G200 = successful get 

# P200 = successful put 

# Locking errors 

# L101 = Lock tokens do not match 

# L102 = missing lock token 



#MISC 

# F108 = invalid FragmentID 

# CI 23 = error in fragment2XML 

# CI 24 = Failed saving content to metadata store 

# G104 = Authorization String Empty 

# D145 = error parsing input stream 
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Evaluation of Franklin and Kittyhawk Integration Concept 

Please use the scenarios to assess the value of an integrated version of Kittyhawk and Franklin Editor. 
After you complete each scenario, please answer the corresponding questions. 

In your assessment of the value of the Franklin concept, please remember there may be Ul problems 
and bugs in this pilot implementation. Try to assess the value of the concept rather than the value of 
this current implementation. 

Use the role Editor in FranklinRole field in your user profile. To create projects and assign tasks, you 
need to be assigned the Kittyhawk role Administrator. 

Note that for Scenarios 1-3 you are playing the role of a Regular User. For Scenarios 4-5, you are 
playing the role of a Superuser. Before beginning tasks 1-3, make sure your Franklin role is KittyHawk 
User profile is set to "Editor" and Superuser to "No". Change to the Superuser to "Yes" for tasks 
4-S. 

I called these A, 8, C etc. lusuo-dktinmiKh '■ — "-( be renumbered 1,2,3 after 

we decide which ones to 



Scenario A: Create ar 

Set Superuser to "Yes" a 
Assume that You are the 
and thumbnails for the Ti 
pages. Other editors will I 
See the definitions of IMP 
http:llfranklin.adtech.intei 

[Here we should give the 
Or should we make this o 
I wanted this to be differe 
each other, does that mak 



) create and publish images 
motions, news and product 
:ote at least one of each. 



;e and publish a fragment 

ruser yet???? 

that Scenarios build on 



Scenario B: Assign and Complete a "Create and Publish" Task for a Product Spec 
fragment 

Set Superuser to "No" and Franklin Role to "Editor" in KH 

Assume that. Enterprise Sites need to host Product information on the latest model in the ThinkPad 
line. This work needs to be delegated to an editor responsible for creating product specs. 
See the definition of PRODUCT SPEC_at 

http:llfranklin.adtech.intern etibm.coml^anklinldownloadsllESiteDTDs.html 
[This would be essentially Scenario I tailored to a Product Spec] 



Scenario C: Assign and Complete a "Create and Publish" Task for a Product Page 

Set Superuser to "No" and Franklin Role to "Editor" in KH 
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Assume that: Enterprise Sites needs to host a series of pages on the latest model in the ThinkPad line. 
The product spec, images and thumbnails have been uploaded earlier, now the tasks of creating and 
publishing a Product Page for the new ThinkPad need to be delegated to an Esite editor. This page is to 
be published for the web only. 

See the definition of PRODUCT PAGE and PRODUCT COMPARISON at 
hnp:llfranklin.adtech.internetibm.comlfrank linldownloadsllESiteDTDsM 

[this would be scenario 2 done once for PRODUCT PACE] 

[questions afterwards would emphasize that product spec, image and thumbnail in first two scenarios 
were reused and did not have to be recreated] 

Scenario D: Assign and Complete a "Create" task and a "Publish" Task for a Product 
Comparison 

Set Superuser to "No" and Franklin Role to "Editor" in KH 

Assume that: Enterprise Sites needs to host a page compariong the latest model in the ThinkPad line 
with older models to highlight it's advantages. The product spec, images and thumbnails have been 
uploaded earlier, now the task of creating a Product Comparison needs to be delegated to an Es/te 
editor and the task of reviewing the work and publishing it to a QA person. This page should be 
published for vie web only. 
See the definition of PRODUCT COMPARISON at 

http:/lfranldin.adtech.internet.ibm.comlfranklinldownhadsllESiteDTDs.html 

[this would be scenario 2 done once for PRODUCT COMPARISON but with separate tasks for Create 
and Publish] 

[questions afterwards would emphasize that product spec, image and thumbnail in first two scenarios 
were reused and did not have to be recreated] 

Scenario E Assign and Complete a "Edit and Publish" Task for a Product Page 

Set Superuser to "No" and Franklin Role to "Editor" in KH 

Assume that: The Product Page on the latest ThinkPad created in Scenario C needs to be published for 
customers with a PDA and a notification sent to customers with Smart Phones. This task needs to be 
delegated to an Esite editor. 

See the definition of PRODUCT PAGE and PUBUSHINFO at 
http:tlfranklin.adtech.internetibm.comlfran klinldownloadsllESte^ 

[this would be scenario 2 done once for PRODUCT PAGE this time with Edit+Publish task] 
[questions afterwards would asl about the overhead of publishing for PDA and phone. 



Scenario F: Identify a problem on the Esites web sites and request that it be fixed 

Set Superuser to "Yes" and Franklin Role to "Editor" in KH 

Assume that While browsing the Esite, you see a bad typo on the Product Page created in Scenario C. 
As a Superuser, you bring the page into Franklin, fix the typo, republish, and verify that all affected 
pages were republished. 
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See the definition of PRODUCTSPEC at 

http:l!frankIin.adtech.internetibm.comlfranklinldownloadsl/ESiteDTDs.html 

[this would be a brand new scenario where user starts by browsing Esites, sees a problem, copies and 
pastes the URL into Franklin fi/e-> RetreiVe by Publish URL checks out the page, checks out the 
imbedded PRODUCT SPEC subfragment, fixes the typo, checks in, reviews all affected pages, 
republishes the PRODUCT SPEC and then goes back to Esites to see that the page has changed. 
I can write the step for this one because it includes some new funcationality that you may not have 
tried yet] 



I Scenario I : Assign and Complete a "Create and Publish" Task for a Fragment 

[this would be incorporated into A and BJ 



/ KittyHawk Steps: Use Administrator Rote 

1. Create a Request 

2. Create a Project and associate the Request 
toft 

3. Create a CREATE AND PU&USH task 

4. ASSIGN the task to a Franklin Editor w/th 
Regular User role (Note: Assign the task to 
yourself so you can complete it using Franklin 
Editor) 

5. Provide a DESCRIPTION of the document 
to be created 

6. Designate a DTD name (e.g. Thumbnail, 
Form, Product Spec, or Form) 

7. SEND the task 

8. Save and close the task, and project 

2 Franklin steps: Use regular Franklin User 
(Editor) role 

1. Launch the Franklin Ul and Login 

2. Get tasks assigned to you 

3. Start the task to create the appropriate 
fragment, fill it in , and check it in 

4. Approve the final pages (and note that 
there are no pages to approve because no 
servable page includes the fragment you just 
created) 

5. Publish the fragment 

3 KittyHawk Steps: Use Administrator Role 



Expected Results 

1. A new task with Status "Sent" should be in 
the task section on the project 

2. Check that the task is in the KittyHawk 
editor queue. 



I. In Franklin, after publish, fragment should 
disappear from the Active List. 



1. Task should have Status "Comp". 

2. Fragment ID should be filled in for the task. 
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/. Open the project with previously assigned 
task 

2. Click Refresh button above Task Section 



View task in Project form. Since all tasks 
the project are complete, you can now click the been complete. 
Begin Final Approval process button. 



3. 'URLs of work' field should be filled on the 
project form. (If fragment is not used in any 
servable pages yet, the message should say 
"No URLs to view. This fragment is not used in 
any final page") 

4. Check that the task is no longer in the 
KittyHawk editor queue. 
Requesters will be notified that the work has 



How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the a 
methodltool you use? KittyhawklFranklin is. . . 
Much Worse Worse About the Better Much Better 

Same 

1 2 3 4 5 

Please explain. 
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Scenario 2: Assign and Complete a "Create and Publish" Task for a Servable Page, 
I use Save as Draft in Franklin 
[this would be replaced and Incorporated into CJ 

Repeat the same steps used in Scenario I, only this time create a servable page by selecting one of 
the following: promotion, productpage, productcomparison or link. 

All other steps are the same as in Scenario I, except 
# Steps Expected Results 

2 Franklin steps: Use regular Franklin User I . Saving as Draft should update the 

(Editor) role "Create+Publish" Task with the fragmentID 

1. Launch the Franklin Ul and login 

2. Get tasks assigned to you 

3. Verify that the "Create+Publish" task has 
no FRAGMENTID associated with it. 

4. Start the task to create the appropriate 
servable document 

5. Search far subfragments to include in the 
document 

6. Cut and paste the desired fragments into 
the document 

7. Select style sheets for the web, the pda, and 
the Slingshot index page. 

8. Preview your work in between edits 

9. Complete filling in the document 

10. Check in the document as a DRAFT 

1 1. Remove it from the Active List 

12. Refresh tasks assigned to you 

13. Verify that the "Create+Publish" task now 
has a FRAGMENTID associated with it 

14. Start the task again 

15. Make further edits 

16. Check document in 

1 7. Verify that document appears highlighted 
in Active List 

18. Approve final pages 

1 9. Publish document 
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Scenario 2 Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/too/ you use? KittyhawklFranklin is... 
Much Worse Worse About the Better Much Better W/ 

1 2 3 4 5 

Please explain. 
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1 Scenario 3: Copy and Paste Fragments from Franklin into a Kittyhawk Project 

[this would stay as is] 
# Steps Expected Results 

1 Log into Franklin. 

2 Click on the search button in left panel. 
Give query parameters, and search for a 
list of Fragments. 

3 Select several fragments. Click copy Copies fragment information to clipboard, 
button. 

4 Open KittyHawk. Open an existing 
project, or create a new project 

5 Oick PASTE FROM FRANKLIN button. Creates a task for each fragment 

io 3 Questions: 



How satisfied are you with the KittyhawklFranklin process for completing this sc 
Very Dissatisfied Dissatisfied Neutral Satisfied 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/too/ you use? KittyhawklFranklin is. . . 
Much Worse Worse About the Better Much Better N// 

1 2 3 4 5 

Please explain. 
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I Scenario 4: Search and try to check out documents in Franklin 
[ [this would stay as is] 

# Steps Expected 

1 Log into Franklin. 

2 Click on the search button in left panel. 
Try out different combinations of search 
attributes, operators and values. Verify 
results. 

3 Select a document in the Search results 
and try to check ft out. 

4 Select a document in the Search results 
and check out for view only. 

5. Try to check in document displays in right Check in 

hand panel 
6 Try to check out document displayed in 

right hand panel. 
7. Remove document displayed in the right 

hand panel from the Franklin Editor 



Check out icon should be disabled. 

Document should appear in Right panel in Read 
only mode. 

should be disabled. 



You should not be able to check it out, a: 
been assigned in a task to you.. 



Scenario 4 Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/tool you use? KittyhawklFranklin is. . . 
Much Worse Worse About the Better Much Better N/7 

1 2 3 4 5 

Please explain. 
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Scenario 5: Assign and Complete an "Edit" task and a "Publish" task for a 
Promotion 



[this would be replaced and incroporated into Scenario D 
Scenario E because it's an Edit, not a Create] 
# Steps 
/ KittyHawk Steps: Use Administrator Role 

1. Create a Request 

2. Create a Project and associate the request 



\e it 's two separate tasks, and 



with it 



:o EDIT a Promotion 



3. Initiate a task 
servable 

4. Click on SEARCH FRANKLIN button to get 
a fragment ID from Franklin 

5. ASSIGN the task to a Franklin Editor with 
Regular User role (yourself in this case) 

6. Send the task 

7. Save and dose task 

8. Initiate a task to PUBUSH the same 
Promotion servable 

9. ASSIGN the task to a Franklin Editor 
(yourself so mat you can complete the task - 
in reality you would assign it to a different 
person than the previous EDIT task) 

10. Close task without sending. 

1 1. Close the project 

Franklin steps: Use regular Franklin User 
(Editor) role 

1. Launch the Franklin Ul and Login 

2. Select Tasks -> SHOW TASK INTERFACE, 



i tasks assigned to you 



3. Start the task to check-out the Promotion. 

3. Edit the Promotion and check it in 

4. Select SHOW TASK INTERFACE to verify 
that task has disappeared. 

KittyHawk Steps: Use Administrator Role 

1. Open the project with previously assigned 
task. 

2. Cfck Refresh button above Task Section. 

3. Edit the PUBLISH task, send it, and dose 
task. 

Franklin steps: Use regular Franklin User 
(Editor) r ole 



I. Se/ect Tasks -> SHOW TASK INTERFACE, 
and view tasks assigned to you 



Expected Results 

1. A new EDIT task with Status "Sent" shou/d 
be in the task section 

2. A new PUBUSH task with Status "New" 
should be in the task section 

2. Check that the EDIT task is in the 
KittyHawk editor queue 



1. In Franklin, the Promotion appears 
highlighted in Active List. 

2. The Check-out, Approve and Publish icons 
should be disabled for the Promotion, as you 
have not been assigned the PUBUSH task at 
this point. 

3. Task should not appear in Task Interface 



1. EDIT task should have Status "Comp". 

2. 'URL of work' field should NOT be filled for 
the EDIT task on the project form. 

3. Check that the EDIT task is no longer in the 
KITTYHAWK editor queue. 

4. PUBUSH task should have Status "Sent" 

1. Starting the PUBLISH task should launch 
t he browser with links to all fi nal paggg_to___ 



preview. 
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2. Start PUBLISH task to begin approval of \ 
final pages. 

3. R a Am an pagf a i i ii the brow ser ~ - 

4. Publish the Promotion 

5. Exit Franklin Editor 
5. KittyHawk Steps: Use Administrator Role 

1. Open the project with previously assigned 
task 

2. Verify that all tasks are complete I 

3. Click on "Begin Final Approval" \ 

4. Copy and paste appropriate URLs of work I 
to Request document. \ 



1. PUBUSH task should have Status "Comp". 

2. 'URL of work' field should be filled in for the 
PUBUSH task on the project form. 

3. Check that PUBUSH task is no longer in the 
KITTYHAWK editor queue. 



Scenario S Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/too/ you use? KittyhawklFranklin is... 
Much Worse Worse About the Better Much Better W/ 

1 2 3 4 5 

Please explain. 
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Scenario 6: Assign a "Publish" Task, Create and Address Problem Report 
[we could include the creation of a problem report in the "publish" part for Scenario D 
or should we leave it as a separate scenario as is so that the scnarios are shorter and 
address fewer functionalities? What do you think?] 



Instead of creating an "Create" task for this one, assu 

# Steps 

1 KittyHawk Steps: Use Administrator Role 
I. Open an existing project 

3. Initiate a task to PUBUSH a Product Page 
servable 

4. Click on SEARCH FRANKLIN button to get 
a fragment ID from Franklin 

4. ASSIGN the task to a Franklin Editor with 
Regular User role (yourself in this case) 

5. Send the task 

6. Save and close task, and project 

2 Franklin steps: Use regular Franklin User 
(Editor) role 

1. Launch the Franklin Ul and Login 

2. Select Tasks -> SHOW TASK. INTERFACE, 
and view tasks assigned to you 

3. Start PUBUSH task to begin approval of 
final pages. 

4. Review pages in the browser 

5. Create a problem report for the web 
document 

6. Double dick on one of the product data 
elements in the table. 

7. Fill in the PROBLEM REPORT and send. 

8. Close the browser 

9. Remove Product Page with problem from 
your Active List 

10. Verify that the PUBLISH task still appears 
in our Task interface. 

3 KittyHawk Steps: Use Administrator Role 

1. Open the project with previously assigned 

2. View the Problem Report 

3. Assign a new "Edit and Publish" task with 
fragmented from Problem Report (assign it to 
yourself) and the problem stated 

4. Franklin Steps: Use regular Franklin User 

(Editor) role to complete the "Edit and Publish" 
task as usual 



ne that a product page has already been 

Expected Results 

1. A new PUBLISH task with Status "Sent" 
should be in the task section 

2. Check that the task is in the KittyHawk 
editor queue 



1. Starting the PUBLISH task should launch the 
browser with links to all final pages to preview. 

2. After clicking on "Create Problem Report!', 
you should see the fragmented and element 
name change in the browser status bar as you 
mouse over the different areas of the page. 

3. Double-clicking on an area should hunch a 
Problem Report form to fill in. 

4. In KittyHawk, task should still appear as 
"Sent" as it was never completed due to 
problem. 



I. Problem Report should appear in the 
Project 
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5. KittyHawk Steps: Use Administrator Role 

1. Refresh task list 

2. Note that "Edit and Publish" task is 
completed 

3. Edit the "Publish" task still uncompleted due 
to Problem Report 

4. Reclick on SEND to resend the task to the 
some editor (to notify him that problem has 
been corrected) 

6. franklin Steps: Use regular Franklin User I. When approving final pages, the cause of the 
(Editor) role to complete the "Publish" task as Problem Report should be fixed. 

frennrio 6 Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/too/ you use? KittyhawklFranklin is. . . 
Much Worse Worse About the Better Much Better M 

1 2 3 4 5 

Please explain. 
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Scenario 7: Create a Superuser Activity Log and View Conflict Reports as 
Superuser 

[this would stay as i 
Change your Supen 



;r flag to "Yes" in your KittyHawk User Profile 



Steps 

Open KittyHawk. Create a project 

Assign several EDIT tasks associated with one 

Fragment ID. 

Assign all to regular Franklin role editors. 
Send Tasks, Save Project, and dose 
KittyHawk. 

Franklin Steps as a Superuser. 

1. Launch Franklin Editor 

2. Se/ect "Rle->Check out by Fragmentid" to 
check out the FragmentID that you assigned 
to other editors in Step 2 

3. View tasks assigned to other editors for the 
document in the Conflict Report. 

4. Click on "OK" to check out anyway 

5. Edit the document 

6. Check it in and view the Conflict Report 

1. Click on "OK" to check in anyway. 
KittyHawk Steps: as Project Administrator 

1. Open the project navigator. 

2. Open the project 

3. Click on the doclink. 



Expected Results 



I. Conflict report should warn user of other 
active tasks on the same fragment 



\s a regular editor, check oi 



As a Superuser, check out a fragment that 
not assigned in the other tasks. 



Edit fragment and check it 



1 0 Repeat test by assigning tasks to other 
Franklin roles in KittyHawk: Image Editor, 
it Editor. 



There is a lightning bok icon in the view to 
indicate that there was 'superuser activity' on 
one of the tasks related to the project. 

2. There is a doclink in the Superuser Activity 
field. The history on the project also indicates 
that there was superuser activity on the project 

3. The superuser activity log is opened. 



fragment that Not allowed because the user cannot see 

The fragment is checked out without any 
warnings. 

The Conflict Report will not appear at check 
out or check in of this fragment until it is 
assigned to a task. 
A superuser activity log is created in 
Ksttyhawk. 



04/08/2005 17:56 561-989-9812 



FLEIT KAIN ET AL. 



Scenario 7 Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/tool you use? KittyhawklFranklin is. . . 
Much Worse Worse About the Better Much Better N/A 

1 2 3 4 5 

Please explain. 



Note that for Scenarios 8-9 you are playing the role of a Supewser. Before beginning, make sure your 
Franklin role is KittyHawk User profile is set to "Editor" and Superuser to "Yes. 

For the pilot we are using 3 Enterprise Sites: Cargill, North Carolina, and Bayer. You must register to 
each one separately, with a different user name, because the registrations cannot be shared between 
different E-Sites. (If you choose to register only at one, make sure you publish content to that E-Site in 
the Scenarios below) 



Scenario 8: Register with the Enterprise Sites, publish and view a Product Comparison 
at an E-Site. 

[this scenario should come earlier, so that they register to Esites, maybe should be after 
Scenarios A and B, the first time they have to actually publish a servable page, not just a 
fragment. I think this should be changed to be A PROMOTION instead of Product 
Comparison because we already have a Product Comparison in Scenario D... 
J 

Expected Results 
After logging on to one E-Site, your browser is 
set with a cookie for that particular E-Site. The 
cookie lasts for the current browser session. 
To register or logon to a different E-Site, you 
need to launch a new browser and go to the 
URL of that site. The 3 E-Site URLs are: 



# Steps 
I E-Site registralion steps: 

1. To register, go to 

httpy/amadeus.sby,ibm.coi™servlet/goI 

2. Click on "Register Now". 
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3. Follow instructions to register until you are 
brought back to the Login screen of the 
Enterprise Site you started from. 



litlp //aniadeui..bby.lbm con 

http://amadeus.sby.ibm.< 
http://amadeus.sby.ibrac 




'scrvlct/gold/NortliCarolina/Welcome 
Dm/servlet/gold/CargillAVelcome 
Dm/servlet/gold/BayerAVelcome 



4. Enter the IBM ID and password you just 
created. 

5. When prompted for the IBM authorization 
code, enter "nclOO" (You will receive this code 
in an e-mail at some point, this gets you 
started faster) 

6. On the home page of the E-Site, dick on 
"Edit Personalization" 

7. Select a Job Type and Check ALL available 
options (to ensure that regardless of interest 
area classification of a document, it will appear 

foryou) . , „„ 

8. Click on "Submit", then click on "Return to 

your IBM home" 

9. Note the different sections of the site: 
Home, Product, News, Solutions, etc. 

1 0. Close the browser. 

1 1. Launch a new browser and repeat steps 
1-10 for the other 2 Enterprise Sites: 
http://amadeus.sby.ibm.com/servlet/gold/CargillAVelcome 
http://amadeus.sby.ibm.com/servlet/gold/BayerAVelcome 

2 Franklin steps: 

1. Launch the Franklin Ul and Login. 

2. Create a Product Comparison. To ensure 
that you will see the document on the E-Site 
under your profile: 

• enter STARTJ3ATE as today or earlier to 
make the article appear immediately 

• se/ect one or more ENTERPISE Sites you 
want it to appear under 

• se/ect the LOCATION, or the section of the 
site you want it to appear under 

. select a few INTEREST_AREAS 

• do not select HOMEJEATURE (it is not 
working for now) 

• select the ]OB_TYPE you set in your E-Site 
profile or "Ml" 

3. Search for Product Specs and Thumbnails 
and include one of each in the Product 
Comparison using Copy and Paste. 
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4. Create a newThinkPad Product Spec (to 
include as the second product in the Product 
Comparison) and check it in. 

5. Copy and Paste the new Product Spec from 
the Active List to the Product Comparison. 

6. Preview the horizontal and vertical style 
sheets and select the one you prefer. 

7. Check in the Product Comparison. 



8. Check out the unpublished subfragment 
using the small check out icon to the right of it 
in the Product Comparison. 

9. Check the fragment back in, then publish it 
from the Active List 

10. Try to check in the Product Comparison 

1 1. Approve the final pages for the Product 
Comparison. 

12. Publish the Product Comparison. 

3. Enterprise Site steps: 

1. Logon to one of the E-sites where you 
published the Product Comparison. 

2. Go to the sect/on you selected under Step 2 
for LOCATION. 

3. Locate the Product Comparison and view the 
document 

4. Franklin steps: 

1. Search and check out the Product 
Comparison 

2. Change the LOCATION tag. 

3. Check in the Product Comparison. 

4. Publish the Product Comparison. 

5. Enterperise Site steps: 

1. Go to the section that corresponds to the 
new LOCATION you specified in Step 4. 

2. Refresh the page in the browser. 

3. Locate the Product Comparison. 

6. Franklin steps: 

1. Check out the Product Spec you created in 
Step 2.4. 

2. Edit the PRICE_DOLLARS field. 

3. Check it in, and Publish. 

7. Enterprise Site steps: 

I. Locate the Product Comparison. 



When trying to check in the Product 
Comparison, a dialogue should alert you that a 
subfragment has not been published. 



When trying to check in the Product 
Comparison, no dialogue should pop up this 



Product Comparison should not appear under 
old LOCATION, and should now appear under 
new LOCATION. There may be a slight delay, 
so try a few times if you do not see the change 
immediately. 



The republish of the Product Spec should have 
triggered the republish of the Product 
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2. Refresh the page. Comparison. There may be a slight delay, so 

3. Verify that it reflects the updated price. try a few times if you do not see the change 

immediately. 



Srmnrto 8 Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 



Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/tool you use? KittyhawklFranklin is. . . 
Much Worse Worse About the 



Better 



Much Better 



N/A 



3 



5 



Please explain. 



Scenario 9: Verify the locking of documents in Franklin 

[this should stay as is] 

Complete this scenario with a collaegue, both of you as Superuser. 



Steps 

Franklin steps: 
User I: 

1. Launch Franklin Editor. 

2. Search for a document of your choice. 

3. Check it out 



Expected Results 
Document appears in right hand panel. 



You should get a dialogue stating that the 
document is locked by User I. Choose to check 
it out for "Read onfy/'. 



User I: 

I. Remove the document fror, 



Document is highlighted in Active List, but n< 
longer checked out 
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4 User 2: You should not get the lock message, and 
I. Check out the document in the right hand document should check out 

5 User I & 2: 

Exit Franklin Editor. 
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Scenario 9 Questions: 

How satisfied are you with the KittyhawklFranklin process for completing this scenario? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very Satisfied 

1 2 3 4 5 

Please explain. 



If this scenario includes tasks you perform, how does KittyhawklFranklin compare to the current 
method/tool you use? KittyhawklFranklin is. . . 
Much Worse Worse About the Better Much Better N/A 

1 2 3 4 5 

Please explain. 
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How to Install Franklin Editor 

1. Create a franklin directory in a location of your choice on your hard drive. These instruction assume 
you create C:\franklin\ 

2. Download the self-extracting FranklinEditor from 

http://monolim.adtech.fatemet.ibm. coin/f ^^ Save the file to a 

temporary directory on you hard drive. 

3. Double-click on FranklinEditor.exe in the temp directory on you hard drive. This will start the 
WinZip Self-Extractor. Under "Unzip to folder" enter C:\franklin\ or the path to the franklin directory 
you created in Step 1. Click on "Unzip". 

4. Go to C:\franklin\FrankIinEditor on your hard drive. Open franklin.properties file in NotePad. If 
the location of your browser is different from the one listed, remove the # in front of browserPath and 
change the value to the appropriate path on your machine. Save and close the file. 

5. Double-click on C:\franklin\^^anklinEdito^\Kr!»- , -"' ' or.bat file. The login screen will popup 
and prompt for your usernaroe -■»» A l team has provided to you. 

How to Dele 

1 . Simply delete the drive. 
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How to Get Started with Franklin Editor 

After installing the Editor by following the How To Install instructions and logging in, you can take the 
actions listed below. When Franklin runs integrated with the KittyHawk workflow engine, a user can 
work in one of two modes: supe ruser or re gular user . 

Note: 

All icons in the Editor UI display a tooltip if you mouse over the icon. 
Useful error messages appear in the status bar at the bottom of the Editor UI. 

ACTIONS FOR SUPERUSER 
felsearch 

Click on the "Search" icon above the Active List. This brings up the Search UI. Select attributes and 
values from the drop down menus. You can add more search conditions using the +/- widget. Click on 
"Submit" to launch the search. 

Hint: A search that will always bring back results is "Page Type is Fragment" 

Once search results are displayed in the table, you can select one or more of them and merge them into 
the Active List in the Editor UI by clicking on the "Merge with Active List" icon la) 

Ucheck Out for Edit 

Select an item in the Active List and click on the "Checkout selected document" icon. If the document is 
not locked by another user, it will appear in the right-hand pane in editable widgets. You can modify any 
fields and resubmit into Franklin server. See "Check in" 

(Ucheck Out for View 

Select an item in the Active List and click on the "View selected document in read only mode" icon. It 
will be displayed in the right-hand page in editable widgets. However, you will not be able to check-it in 
with any changes. You can click on the "Check out" icon above the right-hand pane to check it out for 
edit. 

^Create New Fragment 

Click on the "Create new document" icon. This brings up the list of fragments and pages you are 
allowed to create. Select a fragment, click on "Create". The Editor UI retrieves the correspondig DTD 
from the server and auto-generates the right-hand pane with widgets. The required fields are highlighted 
in yellow, and must be filled in before you are allowed to check in the document. 

Create a New Page 

Create a page the same way you create a fragment. However, note that a page has additional fields that 
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enable it to be turned into a final HTML page and previewed: 

A page includes one or more subfragments. To include a subfragment into a page under construction, 
do the following: 

• Search for all subfragments of the appropriate document type (see Search), and merge them into your 
Active List 

• Select the subfragment you wish to include from the Active List 

• Click on the "Copy" icon above the Active List (iti 

• Click on me subfragment field in the page under construction 

• Click on the "Paste" icon above the right hand pane, [fifl This will write the fragment ID of the pasted 
fragment into the field. 

A page requires "Publishinfo" to be filled in. You must select a publish directory on the server. This 
is where the final page will be saved. You must also enter the final HTML file name for the published 
page. You must also select a style sheet to render the page in HTML. 

See "Preview" to view the final HTML page. 



Once you have created a new document or modified an existing one, click on the "Check in document" 
above the right-hand pane. The document will be validated against the DTD and sent to the Franklin 
server. You can now search for it to check it out again for modifications. 



Before checking in a page, you can preview it by clicking on the "Preview page" icon above the right- 
hand pane. It will launch the browser you specified in the franklin.properties file during installation. The 
browser will display the output HTML generated using the style sheet listed in the first PUBLISHINFO 
of the page. To see all output pages, you need to check-in the page and then click on the "Approve" 



Note that you can make further changes to the page and preview it again before checking it into the 
server. You can also preview any page (but not a fragment) by selecting it from the Active List and 
clicking on the "Preview page" button above the Active List. 

^Approve document 

To approve the publishing of a fragment or a servable, select it in the Active List and click on the 
"Approve final pages for selected document" icon. This will launch a browser and display a list of all 
resulting HTML pages. For a fragment, the list consists of all final HTML pages of all the servables that 
include the fragment as a subfragment. For a servable, the list consists of all final HTML pages of that 
servable. 



W Check in 



[^Preview a Page 




>eate problem report 



If you find a problem with a final page, create the appropriate problem report by clicking on the "Create 
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problem report" icon, 
lilpublish document 

If you find no problems with any of the final pages you are approving, click on the "Publish document" 
icon above the Active List. The selected document will be published to the server. 



Ufa 



Remove current document 

While editing a document in the right-hand pane, you can click on the "Remove current document" icon. 
This will unlock the document on the server and discard the document being edited from the Editor UI. 



ACTIONS FOR REGULAR USER 

Get Task List 

Select "Tasks -> Show Task Interface" from the menu bar to retrieve current tasks assigned to you in the 
workflow engine. 

Ifilupdate Task List 

To refresh the entries in the Task Dialogue, click on the "Update task list" icon. Note that after you first 
launch the Task Dialogue the tasks do not get automatically updated. You have to explicitly ask for the 
list to be updated. 

ISlnitiate Task 

To begin working on an assigned task, select the task and click on the "Initiate selected task" icon. A 
Create task will open a new document template to fill in, an Edit task will check out an existing 
document, and a Publish task will launch a browser to approve pages to be published. Once you check- 
in or publish the document initiated by a task, the task will disappear from the task dialogue. 

task info 

To view task associated with a document in the Active List or in the right hand panel, click on the "View 
task associated with selected document" icon. It will bring up the Task Dialogue with the appropriate 
task selected. Note that this icon is only enabled for documents that are associated with a task. 

The other actions you will be able to take in the Franklin Editor UI as a regular editor are described 
above in the su peruser section . Allowed actions will be identified by the icons being highlighted. 
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Executive Summary 

Participants generally liked the functionality that Franklin provided, and they were generally satisfied 
with the tool overall. Participants liked that Franklin 

♦ Publishes data in as many different formats as desired 

♦ Solves the problem of data maintenance on the Web 

♦ Stores product data in XML 

♦ Provides the ability to publish content without help from developers 

♦ Provides the ability to change content once and have the changes appear in multiple places 

♦ Provides the ability to convert product data to non-Web platforms 

♦ Provides the ability to preview 

♦ Allows sharing of fragments 

♦ Provides better organization of content/data via standardization 

♦ Allows the user to dick around the site and easily change the page 

♦ Allows the user to retrieve documents based on URL 

In addition to these generally positive comments, participants noted areas for improvement In 
particular, participants expressed dislike for the current Ul, or what they called "getting around" in ft 
They recommended, either explicitly or implicitly, several minor changes, such as right-dick options, 
double clicking to open/checkout documents, keyboard shortcuts for copy and paste, a more 
conspicuous icon for the search interface, and a way to sort lists of items in the search interface by 
dicking on headers. They also recommended or implied that some major changes would be valuable. 
Specifically, partidpants suggested enabling users to browse the Web and identify/select servables and 
fragments for editing, and creating a browsable library (distinct from the search interface) of fragments 
and servables that also enables previewing. 

The Franklin team needs to implement the minor changes participants recommended, and also 
consider some of the major changes. The magnitude of the Ul design changes the team undertakes will 
likely depend upon the goals! requirements for Franklin. If the goal is for users to be as efficient as they 
can be using Franklin, and to learn it as quickly as possible, then the Franklin team needs to gather 
more user input to determine the optimal Ul design for interacting with servables and fragments. If the 
goal is only for users to be more efficient than they are currently, then several minor changes to the Ul 
will likely suffice. The usability goals for Franklin will dictate whether more user input and major design 
changes are necessary. 

Recommendations 

The most important recommendation involves completing a design walkthrough. The specific 
recommendations for improving the Ul appear in two categories, one for major design changes, and 
one for minor changes. 

Complete a design walkthrough or head-to-head comparison 

If the goal is for users of Franklin to be as effident as they can be, then the Franklin team needs to 
complete a design walkthrough showing users different possible designs for finding and working with 
servables and fragments. Among these different possible designs would be those of the competition. 
The main goal of the walk through is to determine which design(s) works best Other goals are to 
determine if there is a reason or advantage in continuing to develop a new product, what those 
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advantages are, and whether the new product being considered needs changes to the conceptual 
design. The different designs used can be paper sketches, screen mockups, or a fully funaional tool like 
Franklin is currently. Whichever they are, participants "walk through" accomplishing particular tasks. 
See the UCD site for more information on design walkthroughs (w3.ibm.comlucd). 



Consider the following major Ul changes: 

♦ Additional views (e.g. tree diagrams, or other mechanisms determined by user input) for finding, 
checking out, and previewing fragments and servables 

♦ A feature that allows users to browse the site and find the page/fragment they want, and then 
se/ect and open it from the browser to edit it 

♦ A mechanism allowing users to organize servables and fragments according to their needs 

♦ A preview function in the search interface so users can determine if a fragment or servable is the 
one they want (perhaps previewing the selected fragment or servable in a right pane while the left 
shows the list of fragments or servables) 

Make as many of the following Ul changes as time and resources permit 
° Provide a short tutorial explaining how to get started using Franklin 
a Give default focus to the user name field of the Franklin logon interface (also enable keyboard 
use to logon) 

° Provide easy-to-understand labels for fields in templates 

° When possible, change to standard Lotus or Microsoft icons, or icons that users are more 
familiar with 

a Use text labels with all icons or those icons that may be unfamiliar 

° Make it more obvious that the search button is active when Franklin first launches 

° Enable use of keyboard for all functionality, especially copying and pasting fragments 

<• When users access the directory, open to the location users were last viewing 

a When the Franklin window is resized, adjust the size of option and entry fields so that the 

enure Ul fits into the window; establish a minimum size for entry fields, at which point 

horizontal scrolling is required 
° Do not close the draft when users click save as draft (not sure what all users expect save as 

draft to do, but one person recommended this, use extra discretion here) 
a Provide messages that not only tell users there is a problem, but tell users how to solve the 

problem 

0 Provide messages to indicate why preview will not work in some situations 

° Provide localized help to explain the function of specific fields in templates, or a prominent link 

to a page showing examples of how the data is used 
° Indicate for all fields what information is andlor is not necessary (e.g. whether adding a $ sign 

is necessary in price fields, and whether adding the abbreviation MR is necessary for memory 

fields) 

= Indicate beside the name fields that users need to add file extensions such as .peg or .gif 
n Add right-dick functionality, such as for copying and pasting fragments, or checking out 
fragments and servables 

n Enable users to son search results by creator, dates, etc., by clicking on the metadata headings 
n Ensure user ids and logins aren't case sensitive, and that users get the same search results 

when they type roger tilson or Roger Tilson as the creator 
« To check out fragments, allow users to type names in addition to copying and pasting them 
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" Facilitate double-clicking to open/checkout documents and create new ones 

" Provide more cues in the search interface as to the status of use of fragments and servables: 

are they currently checked out, and are they currently published on the site 
" Provide a way to publish to multiple servers 

Caveats 

This user input will be most valuable as a means to improve the ill and functionality rather than as an 
assessment of the value of Franklin. It will not be very useful as an assessment of the value of Franklin 
for the following reasons: 

♦ At least two participants thought Franklin was for product data only, which caused them to rate 
Franklin lower on key scales 

♦ One participant did not realize that Franklin was intended to be used as part of a workflow 
process, and that they did not use this aspect of the product 

♦ The esites meta data was complex and foreign to this different group of users, which made the 
tasks difficult to complete 

♦ Participants reported that sometimes the instructions were not clear or contained irrelevant 
information, and most could not complete task 8 because the document was not checked out as 
was intended 

If the Franklin team still wants a proof-of-concept user evaluation, then Franklin will need to be 
customized to meet the specific needs of the user group that performs the evaluation. The scripts will 
also need to be pilot tested, since some of the instructions were inaccurate. 

Participants 

Four out of six of the participants currently create or maintain content for Web sites. The other two 
participants are involved in determining which toolfs) the TG group will use to create and manage Web 



Findings 

Participants liked the functionality that Franklin provided. Specifically, they liked that it: 

♦ Publishes data in as many different formats as desired 

♦ Solves the problem of data maintenance on the Web 

♦ Stores product data in XML 

♦ Provides the ability to publish content without help from developers 

♦ Provides the ability to change content once and have the changes appear in multiple places 

♦ Provides the ability to convert product data to non-Web platforms 

♦ Provides the ability to preview 

♦ Allows sharing of fragments (with other content providers? Or documents? Or both?) 

♦ Provides better organization content/data via standardization 

♦ Allows the user to click around the site and easily change the page 

♦ Allows the user to retrieve documents based on URL 

Below are the ratings for three of the post-test questions, and the comments of the participants: 
Overall satisfaction 
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How satisfied are you overall with the Franklin process for completing these scenarios? 
Very Dissatisfied Dissatisfied Neutral Satisfied Very 

Satisfied 

I 4 

Mean Avg: 3.8 (Between Neutral and Satisfied) 

Lynn (Neutral): I liked the way it captured the data and how that data could be used anywhere in as 
many different formats as someone wanted. Getting around the tool was difficult 

Michelle (Satisfied): I believe that Franklin is a good tool to complete a lot of the content management 
tasks. However, the main comment I have is that the instructions for the test are not dear, making it 
difficult for me to evaluate Franklin. The 30min orientation (given the down times) gives only a cursory 
view of the tool. I would be able to give better feedback if I understand it more. 

Dave (Satisfied): Although not impressed in comparison to our other tools. Franklin is a good product It 
gets the job done, is fairly easy to use after being trained and learning how the Ul works, and solves a 
legitimate problem with data maintenance on the Web. 

Getting started 

How easy or difficult was it to get started using Franklin? 

Very Difficult Difficult Neither Difficult Easy Very Easy 

Nor Easy 

I I 3 

Mean Avg: 3.4 (Between Neither/Nor and Easy) 

Lynn (Neither/Nor): When the login screen appears, the top text box should have a set focus on it 

Patty (Easy): The hardest part was understanding the meta data for the e-sftes. 

Phyllis (Difficult): I did not know about the icons to the right of the screen (i.e. check out subfragment 
or add fields). 

I did not know that fragments or subfragments had to be 'merged' onto the active list in order to use 

Dave (Easy): It is not a difficult tool. There were frustrations at the beginning, however. For example, wanting to 
dose the current document, and not finding where the dose button was. (Closing the entire application instead.) 
Also, Copy and Paste did not seem to won\ and other functions that are normally taken for granted in any 
production application. 

Do vou think Franklin needs to be easier to get started using? 
Lynn: Yes. There could be a tutorial provided. 
Patty: No 
Phyllis: Yes 

Michelle: Yes, An average user may not be well versed in "common" software navigation. Need more 
comprehensive training before use and continued support during use. Would be useful to have a help 
manual (local and Web). 
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Dave: Yes. Things as simple as using standard icons for dose, copy, paste, etc would be a great help. 
Although the tool is not hard to learn, the questions are screaming in my mind of why the programmers 
made up their own icons for copy/paste, among other things? 

Ease of using once learned 

How easy or difficult was using Franklin once you had learned how it worked? 

Very Difficult Difficult Neither Difficult Easy Very Easy 

Nor Easy 

2 2 

Mean Avg: 4.S (Between Easy and Very Easy) 

Phyllis (Very Easy): The tool was easy to use after I had received help from Dikran. In the future, the 
eMeeting should be allotted more time to ensure that the introduction may be completed. 

Michelle (Easy): Once you understand how it works, ifs easy though there are little quirks here and 
there. 

Dave (Easy): As mentioned, the initial learning curve is quick, then the tool is easy to work with. The 
exception to this is the product page form, which is way too complex for the average user. 

Comparison with other tools 

How does Franklin compare to the current method/too/ you use to manage the content of Web sites? 
Franklin is. . . 

Much Worse About the Better Much Better NIA 

Worse Same 

2 3 

Mean Avg: 2 (Worse) 

Lynn (Worse): Worse than our new tool. We would have to set up extensive training on the Franklin 
tool and then dedicate resources to be a pseudo help desk. 

Dave (Worse): Although Franklin has some added features, it is missing many more. It seems to be 
more a tool to just manage the XML for product data than for true content management. Also, the Ul 
features need quite a bit of work to make the tool workable for most users. If Franklin could be 
integrated as a part of a complete content management system, it would add a good deal of value. 

Task efficiency 

Tasks users can complete more efficiently using Franklin: 

Lynn: Viewing data under different environments, Storage of XML data 

Phyllis: The ability to publish content without help from developers 

The ability to change content once even though it is located in multiple places 

Dave: Product Spec sheets, conversion of product data to non-Web platforms 
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Lynn: Our tasks are easier to perform. Our new tool will have the ability to modify non*product data. 
Phyllis: None 

In general, would Franklin allow you to c omplete vour tasks more efficiently : 

Lynn: Franklin would allow our team to perform a fraction of our tasks more efficiently. We still have 

the overview page, news, support, press releases and a few other templates. 

Phyllis: Yes. It will reduce the need for help from developers. Content will, consequently, be updated or 
modified more frequently. 

Dave: No. Most of IBM does not have a robust content management tool, and would get great value 
from Franklin. However, PSD has a tool already, and is developing the next generation of that too/. The 
ideal solution would be to integrate the strengths of Franklin with the rest of their tool. 

Franklin advantages 

Lynn: Good way to store XML data. 

Patty: The ability to edit Fragments and their meta data. Also, the ability to preview. 

Phyllis: The ease of publishing content. 

Michelle: Self-service tool for content providers. 
Allows sharing of fragments. 

Better organization of pages/content via standardization. 

Dave: Storage of Product data in XML, available to both Web and non-Web platforms from the same 
Franklin disadvantages 

Lynn: It seems to be limited in entering daw only for products. How does an administrator create new 
style sheets or adjust current ones? 

The Ul needs some work, but we were told not to take that into consideration (a little hard since we 
are trying to use the tool). 

Patty: The user interface needs some improvement, i.e. Colors, help features...Would also like to be 
able to copy an existing fragmentlservable and customize to new content. 

Phyllis: Franklin does not have workflow capabilities. 

Michelle: The Ul is not very friendly. Need to provide extensive training to users. 
Conversely, the "better organization" of content also means that there is lesser flexibility. 
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PAGE 13 



Dove: Lack ofUI. It is not intuitive to use, and therefore requires support and customization for any 
group that wants to use it The fact that Franklin is already being used, yet we are going through this 
exercise to evaluate it for TC, is a perfect example of its need to be improved in ill and flexibility. 

Would you want to use Franklin or similar process/tool? 

Lynn: Yes 

Patty: Yes. However, I am concerned about our content providers. They currently use a home grown 
interface that does not require them to fill in meta-data. Perhaps (just brainstorming) we'd need a 
layer on top of this for those who want to provide content but just use the existing meta data values 
and therefore don't even show them. 

Phyllis: Yes. At this point there is a lengthy turnaround time for content changes since developers are 
given the task of loading content as opposed to content managers/authors. 
Michelle: Yes 

Dave: Yes. Franklin is definitely on the right track. And mentioned previously, if integrated with a more 
complete content solution, it would be a valuable tool. 

What would you most like to change? 

Lynn: The user interface needs to be a //tt/e bit more helpful. I would also like to have seen the 
administrator's pt of view. How does a team create new style sheets? 

Patty: I know we didn't use the workflow part, but I'd like to be able to have a baseline for content, so 
when updates are made the reviewer can see what exactly has changed without reading the entire 
piece of content 

Michelle: Friendlier III. Better navigation. 
Dave: User Interface 
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Scenario 2 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 
I S 

Mean Avg: 3.83 
Comments: 

Can" (Neutral): With or without a content management tool, what we need is a well-ordered, 
well-maintained, user-friendly image library, and when new images are created we need content 
owners to put them into the library. Adopting Franklin (or any other tool) will not automatically cause 
mis to happen. 

Lynn: (Satisfied): It allowed me to complete the task "Content? field should be above "Content 
FileName". When a user browses for an image, they can find it in the local directory then the file 
name just appears in the "Content" field. When browsing for the image, if the user selects one, and it 
is wrong, they have to browse for it again. When they hit that button to browse, the directory is not 
where the user last looked, it is in the Franklin Tool directory. I think it should remember where the 
user looked last 

Patty (Satisfied): Don't think that I, the user, should have to check for duplicate name before creating 
the image. Also, please provide some filename heip...i.e. Naming guidelines. 

Phyllis (Satisfied): I was pleased with the tool AFTER I had help from Dikran. For example, in the 
CONTENTFILENAME field I did not know to add a file extension (i.e. pg) from the error message 
'could not map filename null'. A suggestion for tool improvement is to allow double-clicking on fields. 
For example, upon creating a fragment or page, I was hoping to double-click on the fragment type to 
create it Instead I am forced to dick on the CREATE button on the bottom. 

Michelle (Satisfied): Easy to use. Would be great if Franklin can "remember" where I last pulled my 
files from. "Content File Name" - why can't this be pulled from the file name of the gifljpg 
automatically? 

Dave (Satisfied): The form for submitting images is fairly simple and straightforward. It is easy to work 
with, and being able to view the directory structure on the server is a nice touch. However, the ill is not 
intuitive, and needs work. 



Scenario 3 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 
2 3 I 

Mean Avg: 2.83 (Between Dissatisfied and Neutral) 



Comments: 
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Carl (Dissatisfied): First I couldn't figure out how to get out of "Thumbnail" mode, so I had to shut 
down Franklin and restart it 

Second: I had to re-edit franklin.properties before it would preview the file. The requirement to 
configure franklin.properties will be a huge barrier to most of our prospective content "owners" 
because by and large they are not technical people. With content coming from many people in many 
locations, I see this as a significant barrier to its successful widespread adoption. Rather than 
bottom-line content "owners" uploading content, we will likely end up with a few people on the web 

Third: The Scenario instructions ask you to "refresh tasks assigned to you". I never did figure out how 
to find out what tasks were "assigned to me". I finally ignored this instruction. 
Fourth: When I edited the product page and saved it as a draft, my edits disappeared from the fields 
on the right side of Franklin and the downlevel version reappeared. This is very counter-intuitive. 
Keeping the downlevel version is great, but when you save your edits you should continue to see the 
new version. Each time I checked the document in, my edits would disappear and the downlevel 
version would reappear. 

Fifth: When I checked out the product page, and then did a search, the version I checked out did not 
appear in the search results. It should appear, with a notation that it has been checked out 

Lynn (Neutral): I'm assuming it is a product specialist involved with the creation. 

Patty (Neutral): Insufficient help with error messages. 

Michelle (Neutral): Navigation is difficult especially between search window and main window. "Right 
click" functions would help. 

The instructions are not clear. Some steps don't seem relevant 

Would be very helpful if each meta data has a detail/brief description. Maybe this is not so bad for 
someone who knows the product well. I am not well versed, so I have difficulty. 
Got an error message - "Automation server cannot create object" after Step #18. Dikran said it's a 
security problem. 

Dave (Dissatisfied): The form is too complex for end users. The people who write the content for 
product pages are not technical. Based on our experiences with the first generation of our content 
management tool, if the forms are too complex, even with training, the system just won't get used. The 
process of filling out the form and submitting is fine, but the form needs to be simplified, and the 
terminology on each field has to be written in English, not the field names that make sense to the 
system programmers. 

Scenario 4 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 
3 2 

Mean Avg. 3 A (Between Neutral and Satisfied) 



Comments: 
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Lynn (Neutral): The tool wasn't checking in at all. I tried to modify all the fields and they didn't work 
until I cut out the registered symbol in the summary. Then it checked-in fine. The exact error was, " 
an error parsing input stream". 

Phyllis (Neutral): After I had checked the page in I had gotten the message 'can not preview this page'. 
Does this have something to do with the style sheet for PDA? 

Michelle (Neutral): Instructions not dear. Followed instructions but the PDA link did not show up at the 
"approval pages" stage. Dikran tried it and the PDA link showed up on his pc. 

Dave (Satisfied): The process works, and if the page is already created, the form does not seem as 
daunting as when creating a page from scratch. However, had I not already been shown how to add 
the PDA slyle sheets, I would have had trouble figuring it out on my own, and the style sheets/layout 
are not visually separated from the rest of the fields on the form. 

Scenario 5 

Very Dissatisfied Neutral 

Dissatisfied 

2 

Mean Avg: 3.8 (Between Neutral and Satisfied) 
Comments: 

Lynn (Satisfied): The general thought of capturing data like this is great. The ill is a problem. 
Assuming the person entering in the info is a product specialist, it still doesn't specify whether MB 
should be entered for memory or just a number. 

Phyllis: (Neutral) I had tried to preview my fragment but every time I had clicked on the preview icon 
nothing happened. 

Michelle (Neutral): No explanation of each meta data. A product specialist might know but I am not 
well versed. Had some difficulties understand the fields required. 

Dave (Satisfied): Again, aside from VI complaints, the tool does the job intended. 

Scenario 6 

Very Dissatisfied Neutral Satisfied 

Dissatisfied 

I 4 

Mean Avg: 3.8 (Between Neutral and Satisfied) 
Comments: 

Lynn (Satisfied): I think the purpose behind it is great The product is good at enabling the user to 
complete this scenario. But wlo directions, I would have been lost I used product specs created by 
other people that were already published. I didn't understand why they needed to be 
checked-inlpublished again for my task. 



Satisfied Very 
Satisfied 
2 I 



Very 
Satisfied 
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Phyllis (Satisfied): The too/ is excellent I just had difficult/ adding a product spec since my screen did 
not display the '+' sign to the right of the field. Without asking Dikran, I would not have known to 
scroll to the right of the screen to dick on the '+' sign. 

Michelle (Neutral): Suggest that the "price" meta data field indicate that the "$" is default If not, end 
up with values like "$$3500". 

My thumbnail did not show up. Dikran explained that it is in the index page and not product 
comparison page. 

My Product Comparison page did not show up. The page also did not show up in the search function. 
Recreated the pages twice using different names (replaced "&" with "_" because of XML) . Still did 
not show up. "The requested URUweblProdCompAiiThtml was not found on this server." 

"Caps" or "no caps" for user name/creator field. I logged on Friday under "Michelle Lim". I logged on 
Monday under "michelle lim". When I do searches by creator, I get different results when I use 
"Michelle Lim" and "michelle lim". It's confusing. 

Scenario 7 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 
3 2 

Mean Avg: 4.4 (Between Satisfied and Very Satisfied) 
Comments: 

Lynn (Satisfied): Allows the user to click around the site and easily change the page. 

Patty (Very Satisfied): I'm extremely impressed with the functionality to retrieve based on URL 

Phyllis (Satisfied): This functionality is excellent The only difficulty I had encountered was checking out 
the subfragment I did not see the icon to the right of the product spec field. I kept copying the 
fragment id of the subfragment and going to 'FILE CHECK OUT WITH FRAGMENT ID', which did not 
change the right-side of the screen. 

Michelle (Very Satisfied): This part is easy. =) 



Scenario 8 

Very 



Dissatisfied Neutral Satisfied Very 
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Comments: 

Lynn (Dissatisfied): I couldn't just type the id in the field. I had no conflict report or it wasn't apparent 
as to where it was. 

Phyllis: I could not type the fragmentid into the appropriate field. I did not receive an error message 
stating that another was using the field either. Hence, I could not complete this task. 

Michelle (Neutral): The check out by fragment ID window.... only accepts a cut and paste of the ID. 
Does not allow direct entry into the box. 

Did not get a message that the fragment is locked but a conflict report did come up. However, was 
not given the option to click "OK" and check out anyway (Step #4). Could not evaluate. 

Dave: NIA - There were no tasks in the system, so this scenario did not function as the test described 

Scenario 9 

Very Dissatisfied Neutral Satisfied Very 

Dissatisfied Satisfied 
I 

Comments: 

Lynn: I had no one to work with on this. 

Phyllis: There were no colleagues to test this wilh. Hence, I did not complete this scenario. 

Michelle: Could not evaluate with another user. 

Dave: NIA - 1 was working alone, so could not test with another user. 

Discussion 

The Franklin team may want to establish short-term and long-term goals for the franklin content 
management system. In the short-term, the team could provide many of the fixes that participants in 
this evaluation recommended. In the long-term, the team could examine different possible views and 
mechanisms for interacting with servables and fragments, and provide the optimal solution. Providing 
the smaller fixes will increase user satisfaction, and the ease of completing tasks. The long-term work 
will address the underlying or deeper causes for the participants disliking the current Ul, and will likely 
make a bigger impact on increasing ease of use and user satisfaction. 

Short-term fixes can help users learn the interface, and minimize problems if users' conceptual model 
differs from the model upon which Franklin operates. For instance, the search button is the only button 
operable in the initial view of Franklin. This button, however, is gray and appears too similar in state to 
the other buttons that are inoperable at this point. Providing a better visual cue that users can begin 
work by clicking the search button, and implementing other improvements that users in this evaluation 
recommended, can go a long way toward improving the usability of Franklin. 
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That all of the participants listed the Ul as the primary disadvantage of the product suggests that 
these short-term fixes will not arrive at the optimal solution for interacting with servables and 
fragments, however. More work needs to be done to arrive at a solution that matches the user's 
conceptual model. 

A few of the bigger issues that need to be addressed are: 

• What is the base view for interacting with servables and fragments? 

• What is the start view for interacting with servables and fragments, and is it different from the 
base view? 

• Do users want/need additional views or mechanisms for interacting with servables and fragments? 

• How do users conceptualize organizing fragments and servables? 

• How do users conceptualize accessing servables and fragments? 

• How do users conceptualize moving from a view of documents in a library to a work view? 

Franklin currently opens into the work-plane view in which no documents are visible to beginning users. 
This view could also be considered the base view. One reason users may find Franklin initially difficult to 
use is because much of the functionality is initially hidden. There are not many cues for how to begin. 
An alternative design solution would be to open into a library or browsable view of documents provides 
a search interface for finding and checking out fragments and servables. It may be that users would 
prefer the library of documents, and the ability to preview documents, to be the base view. 

Currently, users enter parameters and search for documents they want to work with, or they can 
retrieve documents based on the URL The search functionality and retrieve based on a URL are both 
very useful tools, but users might like additional functionality and additional views of the content 
Currently, users cannot see from the search interface how documents are organized. Providing a 
browsable library could be one means of providing an overview of the page types, or servables, and the 
fragments that constitute the pages. The library, in the form of a simple tree structure for example, 
could facilitate accessing fragments by the servables that contain them, which in turn could give users 
additional cues as to which fragments are used to create specific servables. 
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- positioning for deeply indented dtds (ie not in iv_mainPane) 

- I noticed one oddity when using the +/-: I added 2 list items to 
listfragment and i only filled in linktitle and description, i 
checked it in, then checked it back out. now when i add more list 
items using +/- , it only adds linktitle and description, not the 4 
fields that should be there, do you know what might be going on? i 
can show you on Monday if this description is cryptic... 

- checkoutForVi ew (like checkout without lock) 

implement checkoutForVi ew which is a get without lock token 
flag on fragment, iv_readonly = false; 
from either active list or search can do a getForview 
- put into edit window (right side) without being able to modify 
disable the checkin button for read-only fragments 

o check it out, can't easily do it] 

, „,„ a „ , _.. _a a checkout, it will just go 

to existing fragment, which is still in read mode] 
^ [3 test. . . wi th new irw' 

- Logout... pr ents or keep for editing 



- offline editi '■ local dtds. 

- stale session j orized 

- show media fi owseLocal entry 

- publish info I aperly indented 

- copy and creal 

- search nresult 

- captitalize fo... smaller; tor table headings... 

- (tagl | tag2)* method hasQualifier doesnt find model with () groupings 

- chuck button for audio fragment, checkoutForVi ew 

- change login init file name ie "franklin_init.xml" -> "/login" 
synch with jeff 
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Scott Smiley 



From: Jon Gibbons 

Sent: Monday, April 04, 2005 4:43 PM 

To: Scott Smiley 

Subject: FW: Franklin Editor Ul 



From: Dikran S Mellksetlan [mailto:Dikran_Melikseaan@us.ibm.com] 
Sent: Thursday, March 24, 2005 2:30 PM 
To: Jon Gibbons 

Cc: Louis Weitzman; Sara Elo-Dean 
Subject: Fw: Franklin Editor UI 



Here is a note dated n to download/install and ui 

client. 

We are still looking at 
1999 timeframe. The a 
could be delivered to pc 




Hi all, 



Install: 

Please go to http://monolith.adtech.intemet.ibm.com/franklin/downloads/index.html for 
"How to download Franklin Editor U I" and 
"How to get started with Franklin Ul" 

Once you have the client installed and running you might want to try the following things: 



Try out: 

1) Search for "Document Type = SoftwareSalesManual", Check-Out from the server the fragment entitled 
"Net. Commerce". This is based on the DTD Patrick provided, filled in with Net. Commerce data. Feel free to 
create a new SWSalesManual fragment to see how the authoring works. 
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2) Search for "Document Type = SWSALESMAN UALPAGE" and select the "Net.Commerce" servable you get 
back. This is a page that imports the fragment in 1) If you merge this document into your Active List, you can 
preview it to see how a page gets rendered into HTML using LotusXSL. You can also check it out to see its 
contents. 

3) Search for "Document Type = PRODUCTPAGE". Check-Out from the server the "Netfinity" servable and 
Preview it. This is another example of a Page made up of 4 subfragments rendered in HTML. 

4) Go wild, create any fragments and pages to get a feel for the editor. The current server is a play space 
Caveats: 

- Please ignore anything entitled "Test" in the search results. Those are ourtests... 

- In the SWSalesManual, the fields containing <P>, <LI> etc... are not yet rendered correctly in the final HTML. 
We are working on integrating the mechanism, small matter of programming... 

User Names: 

Below are your usernames and passwords for the Franklin Editor 
<USER> 

<NAME>Ron Lautmann</NAME> 

<EMAIL>lautmann@us.ibm.com</EMAIL> 

<PASSWORD>ron</PASSWORD> 

<ROLE>Editor</ROLE> 
</USER> 
<USER> 

<NAME>John Dorval</NAME> 

<EMAIL>dorval@us.ibm.com</EMAIL> 

<PASSWORD>john</PASSWORD> 

<ROLE>Editor</ROLE> 
</USER> 
<USER> 

<NAME>Stephen Kennedy</NAME> 

<EMAIL>stephen@us.ibm.com</EMAIL> 

<PASSWORD>stephen</PASSWORD> 

<ROLE>Editor</ROLE> 
</USER> 
<USER> 

<NAME>Patrick Rooney</NAME> 

<EMAIL>rooney@us.ibm.com</EMAIL> 

<PASSWORD>patrick</PASSWORD> 

<ROLE>Editor</ROLE> 
</USER> 
</USERS> 



Don't forget that tooltips exist for all icons.... 

Comments, bug reports welcome, please send to me and i'll pass on... 

Regards, 



Advanced Internet Technology 
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Scott Smiley 

From: Jon Gibbons 

Sent: Monday, April 04, 2005 4:43 PM 

To: Scott Smiley 

Subject: FW: Franklin Editor Ul 



From: Dikran S Meliksetian [mailto:Dikran_Meliksetian@us.ibm.com] 
Sent: Thursday, March 24, 2005 3:33 PM 
To: Jon Gibbons 

Cc: Louis Weitzman; Sara Elo-Dean 
Subject: Fw: Franklin Editor UI 



Jon, 

Here is another email in in it. 

I do not think we will be; 



Dikran 




hi John, thanks for the feedba* 
also oc:ing Louis, who develop 

Sara 



Advanced Internet Technology 
http://w3.webahead.ibm.com 




Sara, 

Thanks it installed no problem. Your team is doing a terrific job. I'm very impressed with the functionality. 
Don't take any of the following comments as criticism - they are just suggestions for improvements. 
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- Usually "check out" means to freeze the document while I 'edit 1 it. 
Franklin checkout seems to mean view it (read only). 

Actually "Check out" does mean to freeze it for edit. Did you notice that there are two check-out buttons side by 
side? 

The tooltips and the icons themselves can be improved to be singificanity different: 
"Check out document" and 'View document' 
instead of 

"Check out fragment or servable" and "Check out fragment or servable in read only mode" 
good point. 

- ISO codes should be stored with the document along with Country name, 
language, etc. 

The ISO code is actually more important since an appl can look up the name 
given the ISO code. 

We thought long about this with Patrick Rooney. It seems that it will be better for editors to select from the names 
not the codes, 

as names are more readable. However, if the editor chooses a name, then the code should be filled in 
automatically by consulting 

the infamous centralized taxonomy server, or a local automatically updated copy of it on the Franklin server, when 
the document is checked in. 

In the case of other code+name pairs, such as IBM divisions, again, it's more likely that a name might change but 
the code 

stays the same, so the code should always be the one searched upon and used server side, but the name should 
be displayed 

to the user for viewing or selection. 

This is not implemented but is a possible way to do it if we go into pilot 

- For items with multiple paragraphs (ie prod description in the Netcommerce 
entry), need way to mark the paragraphs. The xhtml work that Patrick is doing 
may help here. 

yes, that's the functionality we are currently adding... stay tuned 

- There is a paste button on the "Read Only" form. Probably not needed, 
good point. 

- Got an SAX exception checking out the Netfinity product page 
ah, we will check 

- Just a general comment, I know it is hard to do but having a wsiwig 
authoring tool is important. Business uses don't want to see the tags or have 
to type them. The eSites requirements folks were very strong on that 

yes, i realize this is becoming the biggest issue here.... 

- Not sure where some of your button icons come from (maybe they are unix 
versions which I am unfamilair with). I believe most users will be Windows users so 
you might want to standard ze on that :con set. Note cut. copy anclpastn 

- The shades of gray used for the windows us different than the default windows colors 
and it makes the appl look a little out of place - again maybe this is a unix color scheme. 

Of course, this is all nit picky stuff so I'll stop here. 
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Regards, John 



Enterprise Web Management, Advanced e-Business Technology 
Route lOOSomers NY 

Tel. (914)766-1515 Tl 826 Fax x-1869 
Internet dorval@us.ibm.com 

To: Ron Lautmann/Mountain View/1BM@IBMUS, John Dorval/Somers/IBM@IBMUS, Stephen Kennedy/Somers/IBM@IBMUS, Patrick 
Rooney/Boulder/IBM@IBMUS 

cc: Franklin, Maria Hemande//Somers/IBM@IBMUS 
From: Sara Elo/Armonk/IBMglBMUS 
Subject: Franklin Editor Ul 



Hi all, 
Install: 

Please go to http://monolith.adtech.internet.ibm.com/franklin/downloads/index.html for 
"How to download Franklin Editor Ul" and 
"How to get started with Franklin Ul" 

Once you have the client installed and running you might want to try the following things: 



1 )Search for "Document Type = SoftwareSalesWIanual", Check-Out from the server the fragment entitled 
"Net.Commerce". This is based on the DTD Patrick provided, filled in with Net.Commerce data. Feel free to 
create a new SWSalesManual fragment to see how the authoring works. 

2) Search for "Document Type = SWSALESMANUALPAGE" and select the "Net.Commerce" servable you get 
back. This is a page that imports the fragment in 1) If you merge this document into your Active List, you can 
preview it to see how a page gets rendered into HTML using LotusXSL. You can also check it out to see its 
contents. 

3) Search for "Document Type = PRODUCTPAGE". Check-Out from the server the "Netfinity" servable and 
Preview it. This is another example of a Page made up of 4 subfragments rendered in HTML. 

4) Go wild, create any fragments and pages to get a feel for the editor. The current server is a play space. 

- Please ignore anything entitled "Test" in the search results. Those are our tests... 

- In the SWSalesManual, the fields containing <P>, <LI> etc... are not yet rendered correctly in the final HTML. 
We are working on integrating the mechanism, small matter of programming... 

User Names: 

Below are your usernames and passwords for the Franklin Editor 
<USER> 

<NAME>Ron Lautmann</NAME> 

<EMAIL>lautmann@us.ibm.com</EMAIL> 

<PASSWORD>ron</PASSWORD> 

<ROLE>Editor</ROLE> 
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</USER> 
<USER> 

<NAME>John Dorval</NAME> 
<EMAIL>dorval@us.ibm.com</EMAIL> 
<PASSWORD>john</PASSWORD> 
<ROLE>Editor</ROI_E> 
</USER> 
<USER> 

<NAME>Stephen Kennedy</NAME> 
<EMAIL>stephen@us.ibm.com</EMAIL> 
<PASSWORD>stephen</PASSWORD> 
<ROLE>Editor</ROLE> 

</USER> 
<USER> 

<NAME>Patrick Rooney</NAME> 
<EMAIL>rooney@us.ibm.com</EMAIL> 
<PASSWORD>patrick</PASSWORD> 
<ROLE>Editor</ROLE> 

</USER> 
</USERS> 



Don't forget that tooltips exist for all icons.... 

Comments, bug reports welcome, please send to me and i'll pass on.. 

Regards, 
Sara 



Advanced Internet Technology 
http://w3.webahead.ibm.com 
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<?xml version="1.0" encoding="US-ASCH" ?> 
<!DOCTYPE FRANKUNJNIT (View Source for full doctype...)> 
- <FRANKLIN_INIT> 

- < FRAG ME NTS displayname="Fragment"> 

<DTD displayname="Text" 

href= "http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/textfragment.dtd 
<DTD displayname="Image" 

href= ''http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/imagefragment.cl 
<DTD displayname="Audio" 

href= "http://frasier.dhcp.adtech.internet.ibm.com/franklin/xml/audiofragment.dt 
<DTD displayname="Video" 

href="http://frasier.dhcp.adtech.inte rnet.ibm.com/franklin/xml/videofragment.dt 
</FRAGMENTS> 

- <SERVABLES displayname="Page"> 

<DTD displayname="Page one" 

href= "http://frasler.dhcp.adtech.internet.lbm.com/franklin/xml/servableone.dtd" 
<DTD displayname="Page two" 

href= http://frasier.dhcp.adtech.into- " n/franklin/xml/servabletwo.dtd" 

<DTD displayname="P_aa«*' — 

href= "http:/ J i/franklln/xml/foo.dtd ' /> 

</SERVABLES> 

- < SEARCH > 

- <ATTRIBUTELI£ 

<ATTRIBUTE i EATIONTIME" 
class="Time 

<ATTRIBUTE d 
name="LASl 

< ATTRIBUTE di. J ENTSIZE" 

class="Integi 

<ATTRIBUTE dis •lass="Name" /> 

<ATTRIBUTE disi ext" /> 

<ATTRIBUTE disf s="Text" /> 

<ATTRIBUTE disp ' class="Text" /> 

ATTRIBUTE disp, class="Text" /> 

<ATTRIBUTE displ . . , rKE" class="Selectlon" 

options= "http:/ / rranklin/dtd/entities/types.xml" /> 

< ATTRIBUTE displayname="Category" name="CATEGORY" class= "Selection" 
options= ,, http://frasier/franklin/dtd/entities/categories.xml" /> 
</ATTRIBUTELIST> 

- <CLASSLIST> 

- <CLASS name="Time"> 

<OPERATOR» = </OPERATOR> 
<OPERATORX = </OPERATOR> 
<OPERATOR> = </OPERATOR> 
<VALUE type="date" /> 
</CLASS> 

- <CLASS name="Integer"> 

<OPERATOR>>=</OPERATOR> 
<OPERATORX = </OPERATOR> 
<OPERATOR> = </OPERATOR> 
< VALUE type="integer" /> 
</CLASS> 

- <CLASS name="Name"> 
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<OPERATOR>is</OPERATOR> 
<OPERATOR>isn't</OPERAT0R> 
<OPERATOR>startS wlth</OPERATOR> 
<VALUE type="string" /> 
</CLASS> 

- <CLASS name="Text"> 

<OPERATOR>is</OPERATOR> 
<OPERATOR>startS w!th</OPERATOR> 
<VALUE type="string" /> 
</CLASS> 

- <CLASS name="Selection"> 

<OPERATOR>is</OPERATOR> 
<OPERAT0R>isn , t</0PERAT0R> 
< VALUE type= "drop-down" /> 
</CLASS> 
</CLASSLIST> 
- <RESULTS> 

<ATTRIBUTE displayname="Last Modified Date" 

na me= " LASTMODIFIEDTIM E" class="Time" /> 
<ATTRIBUTE displayname="Creator" name="CREATOR" class="Name" /> 
<ATTRIBUTE displayname="Title" name="TITLE" class="Text" /> 
<ATTRIBUTE displayname="Type" name="TYPE" class="Text" /> 
</RESULTS> 
</SEARCH> 
</FRANKLIN_INIT> 



